# Intraface HTTP API

> Every route the Intraface app serves. Errors share one envelope: `{ error: { code, message, hint?, details? } }`.

## Error codes

| Code | HTTP status |
|---|---|
| `bad_request` | 400 |
| `unauthorized` | 401 |
| `forbidden` | 403 |
| `not_found` | 404 |
| `conflict` | 409 |
| `needs_rebase` | 409 |
| `too_large` | 413 |
| `missing_blob` | 422 |
| `missing_asset` | 422 |
| `external_media` | 422 |
| `bad_manifest` | 422 |
| `too_many_new_blobs` | 422 |
| `bad_base` | 400 |
| `rate_limited` | 429 |
| `retry` | 503 |
| `not_implemented` | 501 |
| `upgrade_required` | 426 |
| `unsupported_media_type` | 415 |
| `authorization_pending` | 400 |
| `slow_down` | 400 |
| `expired_token` | 400 |
| `access_denied` | 400 |
| `taken_down` | 451 |
| `blocked_content` | 422 |
| `internal` | 500 |

Base URL: https://app.intraface.cc

## health

- [health](/docs/reference/api/operations/health.md): `GET /api/v1/health`

## boards

- [boards.list](/docs/reference/api/operations/boardslist.md): `GET /api/v1/boards`
- [boards.create](/docs/reference/api/operations/boardscreate.md): `POST /api/v1/boards`
- [boards.get](/docs/reference/api/operations/boardsget.md): `GET /api/v1/boards/{id}`
- [boards.update](/docs/reference/api/operations/boardsupdate.md): `PATCH /api/v1/boards/{id}`
- [boards.revert](/docs/reference/api/operations/boardsrevert.md): `POST /api/v1/boards/{id}/revert`
- [versions.list](/docs/reference/api/operations/versionslist.md): `GET /api/v1/boards/{id}/versions`
- [versions.get](/docs/reference/api/operations/versionsget.md): `GET /api/v1/boards/{id}/versions/{n}`
- [blobs.get](/docs/reference/api/operations/blobsget.md): `GET /api/v1/boards/{id}/blobs/{sha256}`
- [imports.create](/docs/reference/api/operations/importscreate.md): `POST /api/v1/boards/{id}/imports`
- [publishes.create](/docs/reference/api/operations/publishescreate.md): `POST /api/v1/boards/{id}/publishes`
- [comments.list](/docs/reference/api/operations/commentslist.md): `GET /api/v1/boards/{id}/comments`
- [comments.create](/docs/reference/api/operations/commentscreate.md): `POST /api/v1/boards/{id}/comments`
- [members.list](/docs/reference/api/operations/memberslist.md): `GET /api/v1/boards/{id}/members`
- [members.add](/docs/reference/api/operations/membersadd.md): `POST /api/v1/boards/{id}/members`
- [members.remove](/docs/reference/api/operations/membersremove.md): `DELETE /api/v1/boards/{id}/members/{userId}`
- [members.update](/docs/reference/api/operations/membersupdate.md): `PATCH /api/v1/boards/{id}/members/{userId}`
- [invites.list](/docs/reference/api/operations/inviteslist.md): `GET /api/v1/boards/{id}/invites`
- [invites.create](/docs/reference/api/operations/invitescreate.md): `POST /api/v1/boards/{id}/invites`
- [invites.revoke](/docs/reference/api/operations/invitesrevoke.md): `DELETE /api/v1/boards/{id}/invites/{inviteId}`
- [invites.rotate](/docs/reference/api/operations/invitesrotate.md): `POST /api/v1/boards/{id}/invites/{inviteId}/link`
- [viewToken.create](/docs/reference/api/operations/viewtokencreate.md): `POST /api/v1/boards/{id}/view-token`
- [reports.create](/docs/reference/api/operations/reportscreate.md): `POST /api/v1/boards/{id}/reports`
- [events.list](/docs/reference/api/operations/eventslist.md): `GET /api/v1/boards/{id}/events`
- [live](/docs/reference/api/operations/live.md): `GET /api/v1/boards/{id}/live`
- [versions.export](/docs/reference/api/operations/versionsexport.md): `GET /api/v1/boards/{id}/versions/{n}/export`
- [versions.blobs](/docs/reference/api/operations/versionsblobs.md): `GET /api/v1/boards/{id}/versions/{n}/blobs`

## slugs

- [boards.resolve](/docs/reference/api/operations/boardsresolve.md): `GET /api/v1/slugs/{slug}`

## blobs

- [blobs.presign](/docs/reference/api/operations/blobspresign.md): `POST /api/v1/blobs/presign`
- [blobs.upload](/docs/reference/api/operations/blobsupload.md): `PUT /api/v1/blobs/{sha256}`

## publishes

- [publishes.get](/docs/reference/api/operations/publishesget.md): `GET /api/v1/publishes/{id}`
- [publishes.approve](/docs/reference/api/operations/publishesapprove.md): `POST /api/v1/publishes/{id}/approve`
- [publishes.reject](/docs/reference/api/operations/publishesreject.md): `POST /api/v1/publishes/{id}/reject`

## comments

- [comments.resolve](/docs/reference/api/operations/commentsresolve.md): `POST /api/v1/comments/{id}/resolve`

## invites

- [invites.accept](/docs/reference/api/operations/invitesaccept.md): `POST /api/v1/invites/accept`
- [invites.preview](/docs/reference/api/operations/invitespreview.md): `POST /api/v1/invites/preview`

## me

- [me.get](/docs/reference/api/operations/meget.md): `GET /api/v1/me`
- [tokens.revokeSelf](/docs/reference/api/operations/tokensrevokeself.md): `POST /api/v1/me/token/revoke`
- [me.onboarding.get](/docs/reference/api/operations/meonboardingget.md): `GET /api/v1/me/onboarding`
- [me.onboarding.put](/docs/reference/api/operations/meonboardingput.md): `PUT /api/v1/me/onboarding`

## tokens

- [tokens.list](/docs/reference/api/operations/tokenslist.md): `GET /api/v1/tokens`
- [tokens.create](/docs/reference/api/operations/tokenscreate.md): `POST /api/v1/tokens`
- [tokens.revoke](/docs/reference/api/operations/tokensrevoke.md): `DELETE /api/v1/tokens/{id}`

## oauth

- [oauth.approve](/docs/reference/api/operations/oauthapprove.md): `POST /api/v1/oauth/approve`

## cli

- [cli.authorize](/docs/reference/api/operations/cliauthorize.md): `POST /api/v1/cli/authorize`
- [cli.exchange](/docs/reference/api/operations/cliexchange.md): `POST /api/v1/cli/exchange`
- [cli.deviceStart](/docs/reference/api/operations/clidevicestart.md): `POST /api/v1/cli/device`
- [cli.deviceApprove](/docs/reference/api/operations/clideviceapprove.md): `POST /api/v1/cli/device/approve`
- [cli.deviceToken](/docs/reference/api/operations/clidevicetoken.md): `POST /api/v1/cli/device/token`

## webhooks

- [clerk.webhook](/docs/reference/api/operations/clerkwebhook.md): `POST /api/clerk/webhooks`

## orgs

- [orgInvites.list](/docs/reference/api/operations/orginviteslist.md): `GET /api/v1/orgs/{orgId}/invitations`
- [orgInvites.create](/docs/reference/api/operations/orginvitescreate.md): `POST /api/v1/orgs/{orgId}/invitations`
- [orgInvites.revoke](/docs/reference/api/operations/orginvitesrevoke.md): `DELETE /api/v1/orgs/{orgId}/invitations/{invitationId}`

## agent

- [agent.activity](/docs/reference/api/operations/agentactivity.md): `POST /api/v1/agent/activity`
