자동화 업무를 하나의 대화로.

{ media_id: ID, filename: string, content_type: string, size: integer, sha256: string }

GET /v1/me
→ { id, key_scope, permissions, conversation_ids }

{ id: ID, name: string, description?: string, kind?: string, view?: Card }

?limit=20&before=CURSOR
→ { conversations, next_cursor }

GET /v1/conversations/ROOM_ID
→ { conversation }

{ name?: string, description?: string, pinned?: boolean, active?: boolean, view?: Card | null }

{ id: ID, text?: string, attachment_ids?: ID[], card?: Card | null, notify?: boolean }

?limit=20&before=CURSOR
→ { messages, next_cursor }

GET /v1/conversations/ROOM_ID/messages/MESSAGE_ID
→ { message }

GET /v1/conversations/ROOM_ID/events/head
→ { cursor }

GET /v1/conversations/ROOM_ID/receiver-status
→ { receivers, checked_at }

{ sequence: positive_integer, state: "starting" | "receiving" | "processing" | "retrying" | "paused" | "stopped" | "needs_review" | "delivery_pending" }
instance_id: UUID v4

?after=0
?after=0&task_protocol=1
→ { events, next_cursor }

{}
→ { ok: true }

GET /v1/conversations/ROOM_ID/view
→ { view: Card | null }

{ view: Card | null }

?limit=20&before=CURSOR
&category_id=reports&conversation_id=ROOM_ID
&kind=received&status_group=attention
&result_pending=true
kind: received | action | saved
status_group: attention | progress | problems | complete
→ { history, next_cursor }

{ id: ID, title: string, body?: string, category_id?: ID, fields?: Field[], inputs?: object, expires_at?: integer, result_requires_review?: boolean }

GET /v1/conversations/ROOM_ID/tasks/TASK_ID
→ { task }

GET /v1/conversations/ROOM_ID/tasks/TASK_ID/versions
→ { versions: [{revision, title, body, fields, inputs, created_at, change_request}] }

{ request_id: ID, expected_revision: integer, change_request_id?: ID, body: string, title?: string, fields?: Field[], inputs?: object }
Only pending or changes_requested tasks can be revised. Approval is required for every new version.

{ request_id: ID, attempt: integer, execution_token: string }

{ request_id: ID, attempt: integer, execution_token: string }

{ request_id: ID, attempt: integer, execution_token: string, status: "succeeded" | "failed" | "needs_review", result: string, result_links?: [{label: string, url: HTTPS_URL}] }

GET /v1/conversations/ROOM_ID/actions
→ { actions }

{ title: string, description?: string, fields: Field[], category_id?: ID, active?: boolean, expected_revision?: ID }

POST upload.url
Headers: upload.headers
Body: original file bytes

Content-Type: application/octet-stream
X-Pushyou-Filename: URI_ENCODED_FILENAME
Body: original file bytes

Range: bytes=0-65535 (optional)
→ original file bytes

HEAD /v1/media/MEDIA_ID
→ Content-Type, Content-Length, Accept-Ranges

DELETE /v1/media/UNATTACHED_MEDIA_ID