{"components":{"responses":{"Error":{"content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}},"required":["code","message","request_id"],"type":"object"}},"required":["error"],"type":"object"}}},"description":"Request failed; inspect error.code and error.message. 429 includes Retry-After."}},"schemas":{"Conversation":{"properties":{"archived":{"type":"boolean"},"id":{"type":"string"},"kind":{"enum":["public","private","dm"],"type":"string"},"last_message_id":{"type":["integer","null"]},"mentions":{"type":"integer"},"muted":{"type":"boolean"},"name":{"type":"string"},"topic":{"type":"string"},"unread":{"type":"integer"}},"required":["id","name","kind","topic","unread","mentions","muted","archived","last_message_id"],"type":"object"},"ConversationRef":{"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"type":"object"},"ConversationsResponse":{"properties":{"conversations":{"items":{"$ref":"#/components/schemas/Conversation"},"type":"array"}},"required":["conversations"],"type":"object"},"DirectMessageResponse":{"properties":{"conversation_id":{"type":"string"},"duplicate":{"type":"boolean"},"message":{"$ref":"#/components/schemas/Message"}},"required":["conversation_id","message","duplicate"],"type":"object"},"File":{"properties":{"id":{"type":"string"},"mime":{"type":"string"},"name":{"type":"string"},"size":{"type":"integer"}},"required":["id","name","mime","size"],"type":"object"},"Message":{"properties":{"agent":{"type":"boolean"},"author":{"$ref":"#/components/schemas/PersonRef"},"conversation_id":{"type":"string"},"created":{"format":"date-time","type":["string","null"]},"files":{"items":{"$ref":"#/components/schemas/File"},"type":"array"},"id":{"type":"integer"},"reactions":{"items":{"$ref":"#/components/schemas/Reaction"},"type":"array"},"reply_to":{"anyOf":[{"properties":{"id":{"type":"integer"},"name":{"type":"string"},"text":{"type":"string"}},"required":["id","name","text"],"type":"object"},{"type":"null"}]},"sent_via":{"type":["string","null"]},"text":{"type":"string"},"thread_reply_count":{"type":"integer"},"thread_root_id":{"type":["integer","null"]},"webhook":{"type":"boolean"}},"required":["id","conversation_id","author","text","created","thread_root_id","thread_reply_count","reply_to","files","reactions","sent_via","agent","webhook"],"type":"object"},"MessageResponse":{"properties":{"conversation":{"$ref":"#/components/schemas/ConversationRef"},"message":{"$ref":"#/components/schemas/Message"}},"required":["conversation","message"],"type":"object"},"MessagesResponse":{"properties":{"before_message_id":{"type":["integer","null"]},"conversation":{"$ref":"#/components/schemas/ConversationRef"},"has_more":{"type":"boolean"},"messages":{"items":{"$ref":"#/components/schemas/Message"},"type":"array"}},"required":["conversation","messages","has_more","before_message_id"],"type":"object"},"PeopleResponse":{"properties":{"people":{"items":{"$ref":"#/components/schemas/Person"},"type":"array"}},"required":["people"],"type":"object"},"Person":{"properties":{"id":{"type":"string"},"name":{"type":"string"},"online":{"type":"boolean"},"owner":{"type":"boolean"},"status":{"type":["string","null"]},"you":{"type":"boolean"}},"required":["id","name","you","owner","online","status"],"type":"object"},"PersonRef":{"properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]}},"required":["id","name"],"type":"object"},"Reaction":{"properties":{"count":{"type":"integer"},"emoji":{"type":"string"},"mine":{"type":"boolean"}},"required":["emoji","count","mine"],"type":"object"},"ReactionResponse":{"properties":{"message_id":{"type":"integer"},"reactions":{"items":{"$ref":"#/components/schemas/Reaction"},"type":"array"}},"required":["message_id","reactions"],"type":"object"},"ReadResponse":{"properties":{"conversation_id":{"type":"string"},"unread":{"type":"integer"}},"required":["conversation_id","unread"],"type":"object"},"SearchResponse":{"properties":{"before_message_id":{"type":["integer","null"]},"has_more":{"type":"boolean"},"results":{"items":{"allOf":[{"$ref":"#/components/schemas/Message"},{"properties":{"conversation_name":{"type":["string","null"]}},"required":["conversation_name"],"type":"object"}]},"type":"array"}},"required":["results","has_more","before_message_id"],"type":"object"},"SendResponse":{"properties":{"duplicate":{"type":"boolean"},"message":{"$ref":"#/components/schemas/Message"}},"required":["message","duplicate"],"type":"object"},"ThreadResponse":{"properties":{"before_message_id":{"type":["integer","null"]},"has_more":{"type":"boolean"},"replies":{"items":{"$ref":"#/components/schemas/Message"},"type":"array"},"root":{"$ref":"#/components/schemas/Message"}},"required":["root","replies","has_more","before_message_id"],"type":"object"},"Todo":{"properties":{"assignee":{"$ref":"#/components/schemas/PersonRef"},"conversation_id":{"type":["string","null"]},"created":{"format":"date-time","type":["string","null"]},"due":{"type":["string","null"]},"id":{"type":"string"},"message_id":{"type":["integer","null"]},"shared":{"type":"boolean"},"status":{"enum":["pending","done"],"type":"string"},"title":{"type":"string"}},"required":["id","title","status","assignee","due","shared","created","conversation_id","message_id"],"type":"object"},"TodoResponse":{"properties":{"todo":{"$ref":"#/components/schemas/Todo"}},"required":["todo"],"type":"object"},"TodosResponse":{"properties":{"todos":{"items":{"$ref":"#/components/schemas/Todo"},"type":"array"}},"required":["todos"],"type":"object"},"WorkspaceResponse":{"properties":{"app":{"type":"string"},"can_send":{"type":"boolean"},"member_count":{"type":"integer"},"workspace":{"$ref":"#/components/schemas/ConversationRef"},"you":{"properties":{"id":{"type":"string"},"name":{"type":"string"},"owner":{"type":"boolean"}},"required":["id","name","owner"],"type":"object"}},"required":["workspace","you","member_count","can_send","app"],"type":"object"}},"securitySchemes":{"PersonalToken":{"bearerFormat":"Dayroom personal API token","scheme":"bearer","type":"http"}}},"info":{"description":"Personal, workspace-scoped integrations. Create a token at /developers/tokens. All times are UTC. See https://usedayroom.com/docs#rest for response shapes and examples.","title":"Dayroom REST API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/conversations":{"get":{"description":"List the rooms and direct messages you can see, with IDs, topics, unread counts and mentions. Use a conversation ID with GET or POST /conversations/{conversation_id}/messages.","operationId":"list_conversations","parameters":[{"in":"query","name":"kind","required":false,"schema":{"default":"all","enum":["all","rooms","dms"],"type":"string"}},{"in":"query","name":"unread_only","required":false,"schema":{"default":false,"type":"boolean"}},{"in":"query","name":"include_archived","required":false,"schema":{"default":false,"description":"Archived rooms are read-only.","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationsResponse"}}},"description":"Operation succeeded. JSON resource data; no JSON-RPC envelope."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"410":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"security":[{"PersonalToken":[]}],"summary":"List conversations","x-required-scope":"dayroom:read"}},"/conversations/{conversation_id}/messages":{"get":{"description":"Read a room or direct message, oldest first. Thread replies are not included; follow a message with replies using dayroom_read_thread. For older messages pass the returned before_message_id.","operationId":"read_messages","parameters":[{"in":"path","name":"conversation_id","required":true,"schema":{"maxLength":100,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"default":20,"maximum":50,"minimum":1,"type":"integer"}},{"in":"query","name":"before_message_id","required":false,"schema":{"description":"Return messages older than this one.","maximum":9223372036854775807,"minimum":1,"type":"integer"}},{"in":"query","name":"around_message_id","required":false,"schema":{"description":"Return the messages around this one, e.g. a search result.","maximum":9223372036854775807,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessagesResponse"}}},"description":"Operation succeeded. JSON resource data; no JSON-RPC envelope."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"410":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"security":[{"PersonalToken":[]}],"summary":"Read messages","x-required-scope":"dayroom:read"},"post":{"description":"Post a message as you in a room or direct message, optionally as a thread reply. It appears with your name, labelled with this app. To mention someone, include @Their Name in the text and their person ID in mention_ids (\"all\" mentions everyone).","operationId":"send_message","parameters":[{"in":"path","name":"conversation_id","required":true,"schema":{"maxLength":100,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"}},{"in":"header","name":"Idempotency-Key","required":true,"schema":{"maxLength":90,"minLength":8,"pattern":"^[A-Za-z0-9_-]{8,90}$","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"mention_ids":{"items":{"maxLength":100,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},"maxItems":21,"type":"array"},"reply_to_message_id":{"description":"Quote this message in the reply.","maximum":9223372036854775807,"minimum":1,"type":"integer"},"text":{"maxLength":8000,"minLength":1,"type":"string"},"thread_root_id":{"description":"Reply inside the thread that starts with this message.","maximum":9223372036854775807,"minimum":1,"type":"integer"}},"required":["text"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendResponse"}}},"description":"Operation succeeded. JSON resource data; no JSON-RPC envelope."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"410":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"security":[{"PersonalToken":[]}],"summary":"Send a message","x-required-scope":"dayroom:write"}},"/conversations/{conversation_id}/read":{"put":{"description":"Mark a conversation as read for you, up to a message or to the latest one.","operationId":"mark_read","parameters":[{"in":"path","name":"conversation_id","required":true,"schema":{"maxLength":100,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"up_to_message_id":{"maximum":9223372036854775807,"minimum":1,"type":"integer"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadResponse"}}},"description":"Operation succeeded. JSON resource data; no JSON-RPC envelope."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"410":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"security":[{"PersonalToken":[]}],"summary":"Mark as read","x-required-scope":"dayroom:write"}},"/direct-messages":{"post":{"description":"Send a direct message as you to one person, starting the conversation if needed. Get person IDs from dayroom_list_people.","operationId":"send_direct_message","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"maxLength":90,"minLength":8,"pattern":"^[A-Za-z0-9_-]{8,90}$","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"person_id":{"maxLength":100,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},"text":{"maxLength":8000,"minLength":1,"type":"string"}},"required":["person_id","text"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DirectMessageResponse"}}},"description":"Operation succeeded. JSON resource data; no JSON-RPC envelope."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"410":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"security":[{"PersonalToken":[]}],"summary":"Send a direct message","x-required-scope":"dayroom:write"}},"/messages/search":{"get":{"description":"Find messages containing some text across the rooms and direct messages you can see, newest first.","operationId":"search_messages","parameters":[{"in":"query","name":"query","required":true,"schema":{"maxLength":200,"minLength":1,"type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"default":20,"maximum":50,"minimum":1,"type":"integer"}},{"in":"query","name":"before_message_id","required":false,"schema":{"description":"Continue a search from the returned cursor.","maximum":9223372036854775807,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}},"description":"Operation succeeded. JSON resource data; no JSON-RPC envelope."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"410":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"security":[{"PersonalToken":[]}],"summary":"Search messages","x-required-scope":"dayroom:read"}},"/messages/{message_id}":{"get":{"description":"Get one message by ID, with its conversation.","operationId":"get_message","parameters":[{"in":"path","name":"message_id","required":true,"schema":{"maximum":9223372036854775807,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}},"description":"Operation succeeded. JSON resource data; no JSON-RPC envelope."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"410":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"security":[{"PersonalToken":[]}],"summary":"Get a message","x-required-scope":"dayroom:read"}},"/messages/{message_id}/reactions":{"put":{"description":"Add or remove one of Dayroom\u2019s emoji reactions on a message, as you.","operationId":"react","parameters":[{"in":"path","name":"message_id","required":true,"schema":{"maximum":9223372036854775807,"minimum":1,"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"emoji":{"enum":["\ud83d\udc4d","\ud83d\udc4e","\u2764\ufe0f","\ud83d\ude02","\ud83c\udf89","\ud83d\ude4f","\ud83d\udc40","\u2705","\ud83d\udd25","\ud83d\udcaf","\ud83d\ude0a","\ud83d\ude2e","\ud83d\ude22","\ud83d\ude4c","\u2615","\ud83d\ude80","\ud83d\udc4b","\ud83e\udd14","\ud83d\udca1","\ud83c\udf3f"],"type":"string"},"remove":{"default":false,"type":"boolean"}},"required":["emoji"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReactionResponse"}}},"description":"Operation succeeded. JSON resource data; no JSON-RPC envelope."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"410":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"security":[{"PersonalToken":[]}],"summary":"React to a message","x-required-scope":"dayroom:write"}},"/messages/{message_id}/thread":{"get":{"description":"Read a message and its thread replies, oldest first. Pass any message in the thread.","operationId":"read_thread","parameters":[{"in":"path","name":"message_id","required":true,"schema":{"maximum":9223372036854775807,"minimum":1,"type":"integer"}},{"in":"query","name":"before_message_id","required":false,"schema":{"description":"Return replies older than this one.","maximum":9223372036854775807,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreadResponse"}}},"description":"Operation succeeded. JSON resource data; no JSON-RPC envelope."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"410":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"security":[{"PersonalToken":[]}],"summary":"Read a thread","x-required-scope":"dayroom:read"}},"/people":{"get":{"description":"List the people in this workspace with their IDs, status (available, working, away, do not disturb, lunch, sick, out of office) and whether they are online. Use an ID to mention someone, send a direct message or assign a to-do.","operationId":"list_people","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PeopleResponse"}}},"description":"Operation succeeded. JSON resource data; no JSON-RPC envelope."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"410":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"security":[{"PersonalToken":[]}],"summary":"List people","x-required-scope":"dayroom:read"}},"/todos":{"get":{"description":"List to-dos in this workspace: yours by default, or everyone\u2019s you can see. Pending only unless include_done is true.","operationId":"list_todos","parameters":[{"in":"query","name":"mine_only","required":false,"schema":{"default":true,"type":"boolean"}},{"in":"query","name":"include_done","required":false,"schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TodosResponse"}}},"description":"Operation succeeded. JSON resource data; no JSON-RPC envelope."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"410":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"security":[{"PersonalToken":[]}],"summary":"List to-dos","x-required-scope":"dayroom:read"},"post":{"description":"Create a to-do. Without assignee_id it is yours and private; a to-do for someone else defaults to team visibility. Set shared=false to keep an assignment private between you and its assignee.","operationId":"create_todo","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"maxLength":90,"minLength":8,"pattern":"^[A-Za-z0-9_-]{8,90}$","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"assignee_id":{"maxLength":100,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},"due":{"description":"Free text, e.g. \"Friday\" or \"2026-11-02\".","maxLength":120,"type":"string"},"shared":{"description":"Show it to the team. False shares only with you and the assignee.","type":"boolean"},"title":{"maxLength":240,"minLength":3,"type":"string"}},"required":["title"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TodoResponse"}}},"description":"Operation succeeded. JSON resource data; no JSON-RPC envelope."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"410":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"security":[{"PersonalToken":[]}],"summary":"Create a to-do","x-required-scope":"dayroom:write"}},"/todos/{todo_id}":{"patch":{"description":"Mark a to-do done or pending, or change its title, due date or assignee. Only its creator changes the details; its assignee can also change the status.","operationId":"update_todo","parameters":[{"in":"path","name":"todo_id","required":true,"schema":{"maxLength":100,"minLength":1,"pattern":"^[A-Za-z0-9_:-]+$","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"assignee_id":{"maxLength":100,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},"due":{"maxLength":120,"type":"string"},"status":{"enum":["pending","done"],"type":"string"},"title":{"maxLength":240,"minLength":3,"type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TodoResponse"}}},"description":"Operation succeeded. JSON resource data; no JSON-RPC envelope."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"410":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"security":[{"PersonalToken":[]}],"summary":"Update a to-do","x-required-scope":"dayroom:write"}},"/workspace":{"get":{"description":"Who you are in this Dayroom workspace: its name, your name and role, how many people are in it, and whether this connection can send messages.","operationId":"get_workspace","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceResponse"}}},"description":"Operation succeeded. JSON resource data; no JSON-RPC envelope."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"410":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"security":[{"PersonalToken":[]}],"summary":"Workspace and you","x-required-scope":"dayroom:read"}}},"servers":[{"url":"https://app.usedayroom.com/api/v1"}]}