API referenceContacts

Get the project self contact

Returns the project self contact — the @me recipient, seeded from the project owner with isSelf set to true and the reserved alias me — together with its handles.

Endpoint
GET https://api.dairo.app/v1/contacts/me

Returns the project self contact — the @me recipient, seeded from the project owner with isSelf set to true and the reserved alias me — together with its handles. Use it to resolve who @me points at before sending to yourself, or to read the owner's primary email handle. Returns 404 if the project has no self contact. Requires the contacts:read scope.

Scope: contacts:read. Send the API key as a bearer token; Scopes lists what each one reaches.

Request

cURL
curl "https://api.dairo.app/v1/contacts/me" \
  -H "Authorization: Bearer $DAIRO_API_KEY"

Response

200 Success. Body: application/json, ContactDetailResponse.

FieldTypeRequiredDescription
contactContactyes
200
{
  "contact": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "projectId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "alias": null,
    "displayName": "string",
    "kind": "person",
    "isSelf": true,
    "info": null,
    "metadata": {},
    "avatarUrl": null,
    "handles": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "contactId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "projectId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "channel": "string",
        "value": "string",
        "label": "production",
        "isPrimary": true,
        "verified": true,
        "metadata": {},
        "createdAt": "2026-10-19T09:30:00Z",
        "updatedAt": "2026-10-19T09:30:00Z"
      }
    ],
    "createdAt": "2026-10-19T09:30:00Z",
    "updatedAt": "2026-10-19T09:30:00Z"
  }
}

Errors

Every error has the same body, {"error": {"type", "code", "message", "param"}}; branch on code. Errors lists every code.

StatusMeaning
400The request is malformed or a value is invalid (invalid_request, invalid_domain, idempotency_key_mismatch).
401The API key is missing or invalid.
403The key lacks the scope this endpoint needs (scope_missing) or may not do this (not_permitted).
404No such resource in this account (resource_not_found).
422The request is well-formed but a field failed validation (validation_failed).
429Rate limit, plan limit, budget or spend cap reached (rate_limited, plan_limit_reached, budget_exceeded, spend_cap_reached).
500An unexpected error; retry with backoff, then contact support (internal_error).

On this page