IdeaPulleyDocs
GuidesAPI referenceOpenAPI
Open app
  • Introduction
Get started
  • Authentication
  • API basics
  • Errors
  • Rate limits
Endpoints
  • Fund
  • Deals
  • Memos
  • Notes
  • Decisions and outcomes
  • Contacts and reports
  • Evaluations
  • Webhooks
  • More endpoints
Guides
  • Application form
  • Webhook events
  • Claude and ChatGPT (MCP)
  • Zapier, n8n and Polytomic
Errors

Errors

A failed request gets a 4xx or 5xx status and a JSON body that tells you what went wrong.

Error body

403 · application/json
{
  "error": {
    "code": "FORBIDDEN",
    "message": "API key lacks the notes:write scope",
    "status": 403
  }
}

A 400 can also have details, with the fields that are not correct. The older evaluation and webhook routes send { error: { message, code } } or a plain { error } string.

Status codes

StatusMeaning
400 BAD_REQUESTThe body or a parameter is not correct.
401 UNAUTHORIZEDThe key is missing, not correct, revoked or expired.
403 FORBIDDENThe key or its creator's role does not have the scope, or the monthly limit is reached.
404 NOT_FOUNDThe record does not exist, or the key's creator cannot see it.
409 CONFLICTThe Idempotency-Key was used before with a different body.
429 RATE_LIMITEDToo many requests. Wait for the time in Retry-After.
500Server error. Try again later.
IdeaPulleyDocs
GuidesAPI referenceOpenAPI
Open app
  • Introduction
Get started
  • Authentication
  • API basics
  • Errors
  • Rate limits
Endpoints
  • Fund
  • Deals
  • Memos
  • Notes
  • Decisions and outcomes
  • Contacts and reports
  • Evaluations
  • Webhooks
  • More endpoints
Guides
  • Application form
  • Webhook events
  • Claude and ChatGPT (MCP)
  • Zapier, n8n and Polytomic
Errors

Errors

A failed request gets a 4xx or 5xx status and a JSON body that tells you what went wrong.

Error body

403 · application/json
{
  "error": {
    "code": "FORBIDDEN",
    "message": "API key lacks the notes:write scope",
    "status": 403
  }
}

A 400 can also have details, with the fields that are not correct. The older evaluation and webhook routes send { error: { message, code } } or a plain { error } string.

Status codes

StatusMeaning
400 BAD_REQUESTThe body or a parameter is not correct.
401 UNAUTHORIZEDThe key is missing, not correct, revoked or expired.
403 FORBIDDENThe key or its creator's role does not have the scope, or the monthly limit is reached.
404 NOT_FOUNDThe record does not exist, or the key's creator cannot see it.
409 CONFLICTThe Idempotency-Key was used before with a different body.
429 RATE_LIMITEDToo many requests. Wait for the time in Retry-After.
500Server error. Try again later.