# Assignments

The Assignments object allows you to view and manage task assignments for
named or [unnamed resources](https://mavenlink.zendesk.com/hc/en-us/articles/115004696493#Unnamed).

**Note:** Because
[Daily Scheduled Hours](/tag/Daily-Scheduled-Hours-(Story-Allocation-Days))
are a part of Assignments, they can be affected when an assignment changes.

## Fetching a list of Assignments

 - [GET /assignments](https://developer.kantata.com/kantata/specification/assignments/get-assignments.md): For Account Administrators, returns task assignments in all projects across an account.
For non-Account Administrators, returns task assignments only in projects they are part of.


This endpoint returns structured Assignment objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the assignments top-level JSON key.
Please see our Response Format section for more information.

## Creating a new Assignment

 - [POST /assignments](https://developer.kantata.com/kantata/specification/assignments/create-assignment.md): This endpoint returns structured Assignment objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the assignments top-level JSON key.
Please see our Response Format section for more information.

## Fetching a single Assignment

 - [GET /assignments/{id}](https://developer.kantata.com/kantata/specification/assignments/get-assignment.md): This endpoint returns structured Assignment objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the assignments top-level JSON key.
Please see our Response Format section for more information.

## Updating an existing Assignment

 - [PUT /assignments/{id}](https://developer.kantata.com/kantata/specification/assignments/update-assignment.md): This endpoint returns structured Assignment objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the assignments top-level JSON key.
Please see our Response Format section for more information.

## Deleting an existing Assignment

 - [DELETE /assignments/{id}](https://developer.kantata.com/kantata/specification/assignments/delete-assignment.md): Unassigns a resource from a task. The assignment is soft deleted by
setting the current field to false. The assignment is then
considered inactive. Using this endpoint is the same as using
the update an existing assignment
endpoint and setting the current parameter to false.


The response will contain no content and an HTTP 204 status code if the request was
successful, or a standard Kantata OX error message explaining why the object could not be deleted.