Matchai Docs

File a document somewhereComing soon

Adds the document to a listing, a conversation, a project or a team — one file can be in several places. Give remove_from to move it rather than add it.

Coming soon. This is documented ahead of launch so you can plan your integration; it is not available yet.
POST
/documents/{document_id}/places

Coming soon. Adds the document to a listing, a conversation, a project or a team — one file can be in several places. Give remove_from to move it rather than add it.

Scopes: documents:write

Pricing: Included with the connection.

Authorization

headerAuthorizationBearer <matchai_<base62>>

A personal API key, sent as Authorization: Bearer matchai_…. Create keys in Matchai under Settings → Connectors → Advanced (for developers). A key starts with matchai_ followed by letters and digits, carries the scopes chosen when it was created, and can be revoked at any time. Keys reach only the account that created them: to serve other professionals, use Connect with Matchai.

Scope: documents:write

Path Parameters

document_id*string

Document id.

Length1 <= length <= 64

Header Parameters

Idempotency-Key?string

A unique string (a UUID works). Retrying with the same key within 24 hours returns the first response instead of acting twice. Reusing a key with a different body returns 409 idempotency_key_reused.

Length1 <= length <= 255

Request Body

application/json
  1. body

Adds the document to a place. Give remove_from to move it instead of linking it.

type*string
Value in"listing""conversation""project""team"
id*string

Id of that place.

Length1 <= length <= 64
remove_from?

Response Body

The document.

application/json
  1. response

A file in Matchai Cloud. One file can be in several places at once.

id*string

Document id.

Length1 <= length <= 64
name*string

File name.

mime_type?|

File type.

size_bytes?|

Size.

Range0 <= value
visibility*string

private: only people with access to one of its places. public: shown on the listing page to anyone. More levels may be added.

Value in"private""public"
tags*array<>

Tags.

places*array<>

Where it is filed.

summary?|

A short summary, once Matchai has read it.

reading_status*string

Whether Matchai has read the file’s text.

Value in"not_read""reading""done""failed"
download_url?|

A short-lived link to the file. Returned by GET /documents/{document_id} only.

Formaturi
uploaded_at*string

Added.

Formatdate-time
updated_at?|

Last changed.

Formatdate-time
archived_at?|

Moved to the trash. Restorable for 30 days.

Formatdate-time
Example Request
curl -X POST 'https://api.matchai.co/v1/documents/string/places' \  -H 'Idempotency-Key: 6f1d3c2a-0b7e-4f5a-9c8d-1e2f3a4b5c6d' \  -H 'Content-Type: application/json' \  -d '{  "type": "listing",  "id": "string"}'
Example Response
{  "id": "string",  "name": "string",  "mime_type": "string",  "size_bytes": 0,  "visibility": "private",  "tags": [    {      "facet": "kind",      "value": "string"    }  ],  "places": [    {      "type": "listing",      "id": "string",      "name": "string"    }  ],  "summary": "string",  "reading_status": "not_read",  "download_url": "http://example.com",  "uploaded_at": "2019-08-24T14:15:22Z",  "updated_at": "2019-08-24T14:15:22Z",  "archived_at": "2019-08-24T14:15:22Z"}