DevelopersHow to connect an assistantKeys
Developers/Errors

Errors

Every error has a code and a description. It answers with its HTTP status and this body:

JSON
{
  "error": {
    "code": "project_not_found",
    "retryable": false,
    "description": "The project the request names is not one the signed-in person can reach."
  }
}
400conversation_required

The request names no project, and the session has no project of its own to use.

400document_password_protected

The document is protected by a password.

400document_unreadable

The document could not be read.

400document_unsupported_format

The document's format is not one Werk reads.

400due_past

The due date is in the past.

400duplicate_project_step

Two of the steps sent are the same step.

400empty_text

The text is empty once trimmed.

400follow_invitation_unavailable

The person invited has left the project, or the card is no longer visible to both people.

400invalid_account_request

The account request is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number).

400invalid_appearance

The appearance is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number).

400invalid_attachment

A file the request names, or the way it names it, is not one the request takes there; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number).

400invalid_batch

The batch of messages is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number).

400invalid_capture_order

Another message of the batch already holds the place the request gives this one.

400invalid_card_query

The request about cards or their files is not in the form its route takes, or names a day of a filter while the signed-in person's profile has no time zone; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number).

400invalid_card_size

The card size is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number).

400invalid_checklist_request

The list request is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number).

400invalid_choice

The option the request picks is not one the question still offers.

400invalid_client_message_id

The client message id the upload names is not a uuid.

400invalid_client_platform

The client platform the request names is not one Werk serves.

400invalid_connection_name

The name is missing, not text, cleared on a key, longer in characters than it holds, or empty once cleaned of control and direction characters and trimmed; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number).

400invalid_cursor

The page cursor is not one this list gave.

400invalid_device

The device is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number).

400invalid_feedback

The message feedback is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number).

400invalid_feedback_detail

The feedback detail or the report is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number).

400invalid_follow

The follow request is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number).

400invalid_idempotency_key

The Idempotency-Key header is not a uuid.

400invalid_limit

The page size, or the number of entries asked, is not one the list takes.

400invalid_media

The file, its name or the request about it is not in a form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number).

400invalid_message

The message or reminder request is not in the form its route takes, or names a card its reminder is not on; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number).

400invalid_people_request

The people request is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number).

400invalid_plan_activation

The plan activation is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number).

400invalid_plan_transaction

The store transaction the request sends could not be verified for the product it names.

400invalid_project_color

The project color is not one Werk offers.

400invalid_project_name

The project name is missing, empty once trimmed, or longer in characters than it holds.

400invalid_project_order

The project order is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number).

400invalid_project_request

The project request is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number).

400invalid_project_step_label

A step's name is missing, empty once trimmed, or longer in characters than it holds.

400invalid_project_steps

The steps sent leave no step of the right kind for the cards of a step they remove.

400invalid_push_subscription

The web push subscription is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number).

400invalid_query

The query is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number).

400invalid_read

The read mark is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number).

400invalid_read_anchor

The message the read mark names is not one of the signed-in person's chat in this project.

400invalid_registration_context

The invitation code or link the sign-up names is not one the new account can join with.

400invalid_reply_context

The message the answer replies to is not one Werk sent to the signed-in person.

400invalid_setting

The setting, its value or the read of its history is not one the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number).

400invalid_translation_request

The translation request is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number).

400list_exists

The card already has a list.

400locale_unserved

The language the request names is not one Werk serves.

400name_reserved

The name is a verified app's name, which no key or connection a person names takes.

400order_mismatch

The order sent does not hold exactly the list's entries.

400personal_project_unavailable

The signed-in person's own My Werk is not available to hold a reminder with no card.

400personal_reminder_invalid_time

The reminder's time is not one a reminder can be set to.

400personal_reminder_limit

The signed-in person already has as many reminders on this card as one person can have on a card.

400personal_reminder_text_too_long

The reminder's text is longer than a reminder holds.

400photo_side_too_large

The photo's longer side has more pixels than this request takes.

400project_first_step_not_open

The steps sent put a step that is not of an open kind first.

400project_last_step_not_finished

The steps sent put a step that is not of a finished kind last.

400template_not_hideable

The step template the request names is Werk's simple one, which is never hidden.

400text_too_long

The text has more characters than its field holds.

400too_few_project_steps

The project would have fewer steps than a project needs.

400too_many_items

The card's list would hold more entries than a list holds.

400too_many_project_steps

The project would hold more steps than a project holds.

400unsupported_media_type

The file's type is not one the route takes.

401account_code_expired

The sign-in code has expired.

401account_code_locked

The sign-in code was tried wrongly too many times and is locked.

401account_code_used

The sign-in code was already used.

401invalid_account_code

The sign-in code is not the one sent to the account.

401invalid_pairing_code

The pairing code is not a valid code.

401session_context_changed

The account or person the session names changed while the request was in flight.

401session_expired

The session has expired.

401session_revoked

The request carries no session the server holds, or its session has ended.

401unauthorized

The account the request signs in to is deleted or being deleted.

403account_suspended

The account is suspended.

403actor_not_allowed

The signed-in person may not make this change to the card.

403beta_access_required

The account is not on the list of people the beta admits.

403beta_code_invalid

The beta access code is not a valid one.

403device_proof_invalid

The device the request names, or its proof, does not match the device registered for this session.

403due_notice_owner_admin_required

Only the project's owner or an admin sets a card's due notice.

403follow_invitation_actor_not_allowed

The signed-in person may not invite anyone to follow a card here.

403not_a_member

The signed-in person is not in the project.

403not_for_client

The route, setting or input the request names is open only to Werk's own apps, and the request's session is a connected app's or an API key's.

403not_permitted

The signed-in person's role, or whose the record is, does not allow this request.

403origin_refused

The request came from a web origin the server does not accept.

403personal_project_restricted

The request acts on the signed-in person's own My Werk, which only they see, or on a reminder with no card, which lives there, and My Werk does not take this action.

403personal_reminder_actor_not_allowed

The signed-in person may not set or change a reminder here.

403personal_reminder_not_owner

The reminder belongs to another person.

403personal_reminder_recipient_not_allowed

The person the reminder is shared with is not one who can see its card.

403photos_unavailable

Photos are not open to the signed-in person.

403plan_funding_foreign_participant

A person the request names for the plan's funding is not one this plan may fund.

403project_not_permitted

The signed-in person's role in the project does not allow this request on the project.

403voice_unavailable

Voice notes are not open to the signed-in person.

404api_key_not_found

The key id names none of the signed-in person's live API keys.

404asset_not_found

The file the request names is not one the signed-in person can reach where the request names it, or is no longer available.

404batch_not_found

The batch of messages the request names is not one of this device.

404checklist_item_not_found

The list entry the request names is not on the card's list.

404connect_request_not_found

The handle names no open authorization request: it is unknown, expired, or already approved or denied.

404connection_not_found

The connection id names none of the signed-in person's live connections.

404conversation_not_found

The project the request names, or its chat, is not one the signed-in person is in.

404download_grant_invalid

This download address is not one Werk gave, or it was changed.

404follow_invitation_not_found

The invitation to follow a card that the request names is not one waiting for the signed-in person.

404invitation_not_found

The invitation the request names is not an open one of this project.

404item_not_found

The card the request names, or its list, is not one the signed-in person can see.

404member_not_found

The person the request names is not one of Werk's people.

404not_found

The route or record the request names does not exist, or is not one the signed-in person can reach.

404notice_not_found

The notice the request names is not one of the signed-in person's.

404person_not_found

The person the request is about is not one the signed-in person can reach.

404personal_reminder_invitation_not_found

The invitation to a shared reminder that the request names is not one waiting for the signed-in person.

404personal_reminder_not_found

The reminder the request names is not one the signed-in person can reach.

404project_not_found

The project the request names is not one the signed-in person can reach.

404project_photo_not_found

The project has no photo, or none at the version the request names.

404recipient_not_found

The person a message is for, or the message, is no longer one Werk delivers to.

404template_not_found

The step template the request names is not one the signed-in person has.

404update_not_found

The update the request names is not on the card.

404upload_grant_invalid

This upload address is not one Werk gave, or it was changed.

409account_owns_projects

The account owns projects with other people in them, which the details list, so it cannot be deleted.

409appearance_conflict

The project's look for the signed-in person changed after the revision the request names.

409asset_already_submitted

The uploaded file already went with another request; an upload goes with one request only.

409batch_already_open

A batch of messages sent from this device is already open for the project.

409batch_closed

The batch of messages the request names is already closed.

409batch_expired

The batch of messages the request names has expired.

409card_archived

The card is archived, so it does not take this change.

409client_update_required

The app release that sent the request is older than the server accepts.

409code_key_changed

The invitation code or link was made with a key the server no longer holds.

409collaborator_unfunded

The project owner's plan does not fund the signed-in person, a collaborator in the project.

409connection_name_fixed

This connection's name is its verified app's and is not changed.

409cursor_expired

The page cursor no longer fits the list as it stands or the arguments it was read with.

409device_required

The session has no registered device, which this request needs.

409download_grant_expired

This download address has expired and gives no file.

409follow_invitation_expired

The invitation to follow a card has expired.

409follow_invitation_request_conflict

The request id was already used for another invitation to follow a card.

409follow_invitation_source_expired

The message the invitation to follow a card was made from is too old to make it now.

409follow_invitation_stale

The card changed after the version the invitation to follow it names.

409google_calendar_start_expired

The Google Calendar connection this request completes has expired.

409idempotency_conflict

The request's key, or the upload address it was sent to, was already used with other content.

409input_source_conflict

A file the message carries no longer matches what was stored for it when it was sent.

409invalid_input_facts

The stored facts that a sent file's cost is counted from are missing or do not agree.

409item_version_conflict

The card changed after the version the request names.

409legacy_submission

The message was first sent by an app release whose sends cannot be repeated in a batch.

409message_in_custody

The message is already held by another batch of sends.

409personal_reminder_invitation_expired

The invitation to the shared reminder has expired, or its reminder has already rung.

409personal_reminder_request_conflict

The request id was already used with another reminder request.

409personal_reminder_source_expired

The message the reminder was asked in is too old to set it now.

409personal_reminder_stale

The reminder or its card changed after the version the request names.

409plan_activation_refused

The verified store transaction does not activate a plan, for the reason the details name.

409plan_funding_capacity

The plan funds fewer people than the request names.

409plan_funding_own_plan_participant

A person the request names for the plan's funding pays with a plan of their own.

409plan_funding_unavailable

The signed-in person has no plan whose funding can be set.

409plan_funding_version_conflict

The plan's funding changed after the version the request names.

409plan_limit

The plan that pays for this use has too little left this month for this request.

409plan_unavailable

No plan pays for this use by the signed-in person.

409project_archived

The project is archived, so it does not take this request.

409project_config_changed

The project's setup, or the projects the request covers, changed after the version the request names or while it ran.

409project_deleted

The project is being deleted.

409project_deletion_expired

The time to restore the deleted project has passed.

409project_not_archived

The project is not archived.

409project_not_deleting

The project is not being deleted.

409project_order_mismatch

The order sent does not hold exactly the signed-in person's projects.

409project_profile_changed

The project's setup changed while the cards were read.

409request_conflict

The request id was already used with another request, or the change it asks could not be made to the record it names.

409request_erased

The request id belongs to a request whose record was erased.

409reserved_project_name

The project name is one Werk keeps for the person's own My Werk.

409revision_conflict

The card's list changed after the revision the request names.

409session_changed

The session changed while the request was in flight.

409setting_version_conflict

The setting changed after the version the request names.

409share_used

The signed-in person's share of the project owner's plan has too little left this month for this request.

409sign_in_start_expired

The sign-in start the request names cannot be used by this request.

409source_expired

The message the list change was asked in is too old to make it now.

409source_unavailable

A file the request needs, or a record stored for it, is no longer available.

409unsupported_input_tariff

A sent file is of a kind whose cost no tariff counts.

409upload_grant_expired

This upload address has expired and takes no file.

413document_too_large

The document has more bytes than Werk reads.

413payload_too_large

The request body has more bytes than the route takes.

rate_limited

More requests of this kind were sent than Werk takes within the time it counts them over.

500server_error

The server could not complete the request, and it is not known whether a write it holds was made.

503sign_in_unavailable

This server has no sign-in with the provider the request names.