Developer Portal | TaskNation

Error Handling

TaskNation API errors follow the RFC 7807 Problem Details standard. Every error response includes a traceID for debugging with our support team.

Error Response Format

{
  "type": "https://api.tasknation.com/errors/validation-error",
  "title": "Validation Error",
  "status": 422,
  "detail": "The 'zipCode' field must be a 5-digit US zip code.",
  "traceID": "trace_abc123xyz",
  "errors": [
    {
      "field": "zipCode",
      "message": "Must be exactly 5 digits",
      "code": "INVALID_FORMAT"
    }
  ]
}

Common Status Codes

Code	Meaning	Action
`400`	Bad Request	Check request body/params
`401`	Unauthorized	Refresh your access token
`403`	Forbidden	Check scopes — wrong prefix?
`404`	Not Found	Resource doesn't exist
`409`	Conflict	Duplicate resource or stale data
`422`	Validation Error	Fix input per error details
`429`	Rate Limited	Back off per Retry-After header
`500`	Internal Error	Retry; contact support with traceID