agency-time

PATCH `/v1/agency/time/tasks/{taskId}`

Rename or archive a task.

Аутентификация

Передайте API-ключ в качестве маркера носителя (bearer token). Эта конечная точка не указывает конкретное разрешение в спецификации, поэтому предоставьте своему ключу минимум необходимых прав и проверьте ответ, вместо того чтобы делать предположения.

Этот эндпоинт не принимает идентификатор организации. Ваш ключ уже определяет организацию, к которой он принадлежит, и ответ ограничивается ее рамками.

Попробовать

Замените всё в угловых скобках на собственные значения, а плейсхолдер ключа — на ключ из вашей панели управления.

curl -X PATCH https://api.zinndigital.com/v1/agency/time/tasks/{taskId} \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{  }'

Вошли в систему? Консоль API в вашей панели управления автоматически подставляет реальный идентификатор вашей организации и ваш собственный ключ, а также выполняет запрос к работающему API, чтобы вы могли увидеть актуальный ответ. Откройте эту конечную точку в API-консоли

Подробнее

⛔ Archives; never deletes, and the database enforces it — `TimeEntry.task` is `PROTECT`ed, so a task with hours against it cannot be removed. Deleting one would orphan the record of what those hours were for.

Параметры

Имя	Тип	Обязательно	Что это
`taskId (path)`	`string`	Да	—

Тело запроса

Имя	Тип	Обязательно	Что это
`name`	`string`	Нет	—
`archived`	`boolean`	Нет	—

Ответ

Имя	Тип	Обязательно	Что это
`id`	`string`	Да	—
`project_id`	`string`	Да	—
`name`	`string`	Да	—
`archived`	`boolean`	Да	—
`fixed_price_billed`	`boolean`	Да	Whether this task's FIXED price has already been invoiced. Surfaced so the screen can say "already billed" rather than showing further hours on it as free work.

Ошибки, которые может возвращать этот эндпоинт

401 · 403 · 404

PATCH /v1/agency/time/tasks/{taskId}