{ "openapi": "3.1.0", "info": { "title": "AsyncUp API", "version": "0.1.0", "description": "The JSON API the AsyncUp web app uses. Browser sessions must send `X-Requested-With: asyncup` on requests that change state.", "license": { "name": "MIT", "identifier": "MIT" } }, "servers": [ { "url": "/api/v1" } ], "security": [ { "bearer": [] }, { "session": [] } ], "paths": { "/openapi.json": { "get": { "operationId": "getOpenapiJson", "summary": "This OpenAPI document", "description": "No sign-in needed.", "tags": [ "Meta" ], "security": [], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} } } } } } } }, "/auth/methods": { "get": { "operationId": "getAuthMethods", "summary": "Which sign-in methods are switched on", "description": "No sign-in needed.", "tags": [ "Meta" ], "security": [], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AuthMethods" } } } } } } }, "/me": { "get": { "operationId": "getMe", "summary": "The caller and their role", "description": "Any signed-in caller.", "tags": [ "Meta" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Me" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "patch": { "operationId": "patchMe", "summary": "My timezone and vacation", "description": "A signed-in person with a Chat identity; the operator token cannot act as one.", "tags": [ "Me" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MyPatch" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MySettings" } } } }, "400": { "description": "Invalid input; `error.field` names it", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Conflicts with the current state", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/standups": { "get": { "operationId": "getStandups", "summary": "Standups the caller can see", "description": "Any signed-in caller.", "tags": [ "Standups" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StandupList" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "post": { "operationId": "postStandups", "summary": "Create a standup", "description": "Workspace admins and the operator token. Needs the “Create standups” permission (`standups.create`).", "x-permission": "standups.create", "tags": [ "Standups" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateStandup" } } } }, "responses": { "201": { "description": "Created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatedStandup" } } } }, "400": { "description": "Invalid input; `error.field` names it", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Conflicts with the current state", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/standups/{id}": { "get": { "operationId": "getStandupsId", "summary": "One standup with its roster and admins", "description": "Any signed-in caller. Needs the “See standups” permission (`standups.view`).", "x-permission": "standups.view", "tags": [ "Standups" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Standup id", "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StandupDetail" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "patch": { "operationId": "patchStandupsId", "summary": "Change a standup’s settings", "description": "Admins, and managers of the standup or person concerned. Needs the “Configure standups” permission (`standups.configure`).", "x-permission": "standups.configure", "tags": [ "Standups" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Standup id", "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StandupPatch" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StandupSummary" } } } }, "400": { "description": "Invalid input; `error.field` names it", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "delete": { "operationId": "deleteStandupsId", "summary": "Delete an archived standup and all its history", "description": "Workspace admins and the operator token. Needs the “Delete standups” permission (`standups.delete`).", "x-permission": "standups.delete", "tags": [ "Standups" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Standup id", "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteStandupBody" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeletedHistory" } } } }, "400": { "description": "Invalid input; `error.field` names it", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Conflicts with the current state", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/standups/{id}/archive": { "post": { "operationId": "postStandupsIdArchive", "summary": "Archive a standup", "description": "Admins, and managers of the standup or person concerned. Needs the “Archive standups” permission (`standups.archive`).", "x-permission": "standups.archive", "tags": [ "Standups" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Standup id", "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArchiveResult" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/standups/{id}/unarchive": { "post": { "operationId": "postStandupsIdUnarchive", "summary": "Bring an archived standup back", "description": "Admins, and managers of the standup or person concerned. Needs the “Archive standups” permission (`standups.archive`).", "x-permission": "standups.archive", "tags": [ "Standups" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Standup id", "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArchiveResult" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/standups/{id}/run-now": { "post": { "operationId": "postStandupsIdRunNow", "summary": "Start today’s run now", "description": "Admins, and managers of the standup or person concerned. Needs the “Configure standups” permission (`standups.configure`).", "x-permission": "standups.configure", "tags": [ "Standups" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Standup id", "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunNow" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/standups/{id}/nudge": { "post": { "operationId": "postStandupsIdNudge", "summary": "Remind everyone still expected today", "description": "Admins, and managers of the standup or person concerned. Needs the “Configure standups” permission (`standups.configure`).", "x-permission": "standups.configure", "tags": [ "Standups" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Standup id", "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Nudged" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Conflicts with the current state", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/standups/{id}/runs": { "get": { "operationId": "getStandupsIdRuns", "summary": "Recent runs", "description": "Any signed-in caller. Needs the “See reports” permission (`reports.view`).", "x-permission": "reports.view", "tags": [ "Runs" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Standup id", "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, { "name": "limit", "in": "query", "required": false, "description": "How many runs, newest first", "schema": { "default": 14, "type": "integer", "minimum": 1, "maximum": 90 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunList" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/standups/{id}/runs/today": { "get": { "operationId": "getStandupsIdRunsToday", "summary": "Today’s run, for polling", "description": "Any signed-in caller. Needs the “See standups” permission (`standups.view`).", "x-permission": "standups.view", "tags": [ "Runs" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Standup id", "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TodayRun" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/standups/{id}/runs/{date}": { "get": { "operationId": "getStandupsIdRunsDate", "summary": "One day’s run with every submission", "description": "Any signed-in caller. Needs the “Read answers” permission (`answers.view`).", "x-permission": "answers.view", "tags": [ "Runs" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Standup id", "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, { "name": "date", "in": "path", "required": true, "description": "YYYY-MM-DD", "schema": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunDetail" } } } }, "400": { "description": "Invalid input; `error.field` names it", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/standups/{id}/insights": { "get": { "operationId": "getStandupsIdInsights", "summary": "Weekly participation, mood and blocker trends", "description": "Any signed-in caller. Needs the “See reports” permission (`reports.view`).", "x-permission": "reports.view", "tags": [ "Runs" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Standup id", "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, { "name": "weeks", "in": "query", "required": false, "description": "How many weeks back", "schema": { "default": 8, "type": "integer", "minimum": 1, "maximum": 26 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Insights" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/standups/{id}/export.csv": { "get": { "operationId": "getStandupsIdExportCsv", "summary": "Submissions as CSV", "description": "Admins, and managers of the standup or person concerned. Needs the “Export” permission (`export`).", "x-permission": "export", "tags": [ "Runs" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Standup id", "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, { "name": "days", "in": "query", "required": false, "description": "How many days back", "schema": { "default": 90, "type": "integer", "minimum": 1, "maximum": 365 } } ], "responses": { "200": { "description": "OK", "content": { "text/csv": { "schema": { "type": "string" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/standups/{id}/webhook/secret": { "get": { "operationId": "getStandupsIdWebhookSecret", "summary": "The key this standup’s webhooks are signed with", "description": "Admins, and managers of the standup or person concerned. Needs the “Configure standups” permission (`standups.configure`).", "x-permission": "standups.configure", "tags": [ "Standups" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Standup id", "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookSecret" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Not available on this server", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/standups/{id}/members": { "get": { "operationId": "getStandupsIdMembers", "summary": "Members of the standup’s Chat space, as roster candidates", "description": "Admins, and managers of the standup or person concerned. Needs the “Manage people” permission (`people.manage`).", "x-permission": "people.manage", "tags": [ "Roster" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Standup id", "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SpaceMembers" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Google Chat did not answer", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/standups/{id}/manager-candidates": { "get": { "operationId": "getStandupsIdManagerCandidates", "summary": "People who can be picked as a reporting manager", "description": "Admins, and managers of the standup or person concerned. Needs the “Manage people” permission (`people.manage`).", "x-permission": "people.manage", "tags": [ "Roster" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Standup id", "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagerCandidates" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/standups/{id}/roster/sync": { "post": { "operationId": "postStandupsIdRosterSync", "summary": "Sync the roster with its Google Group, or with its Chat space, now", "description": "Admins, and managers of the standup or person concerned. Needs the “Manage people” permission (`people.manage`).", "x-permission": "people.manage", "tags": [ "Roster" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Standup id", "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RosterSynced" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Google Chat did not answer", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Not available on this server", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/standups/{id}/participants": { "post": { "operationId": "postStandupsIdParticipants", "summary": "Add someone to the roster", "description": "Admins, and managers of the standup or person concerned. Needs the “Manage people” permission (`people.manage`).", "x-permission": "people.manage", "tags": [ "Roster" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Standup id", "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AddParticipant" } } } }, "responses": { "201": { "description": "Created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AddedParticipant" } } } }, "400": { "description": "Invalid input; `error.field` names it", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/standups/{id}/participants/{userName}": { "patch": { "operationId": "patchStandupsIdParticipantsUserName", "summary": "Change someone’s role on the roster", "description": "Admins, and managers of the standup or person concerned. Needs the “Manage people” permission (`people.manage`).", "x-permission": "people.manage", "tags": [ "Roster" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Standup id", "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, { "name": "userName", "in": "path", "required": true, "description": "Chat user resource name, URL-encoded (users%2F123)", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateParticipant" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdatedParticipant" } } } }, "400": { "description": "Invalid input; `error.field` names it", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Conflicts with the current state", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "delete": { "operationId": "deleteStandupsIdParticipantsUserName", "summary": "Remove someone from the roster", "description": "Admins, and managers of the standup or person concerned. Needs the “Manage people” permission (`people.manage`).", "x-permission": "people.manage", "tags": [ "Roster" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Standup id", "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, { "name": "userName", "in": "path", "required": true, "description": "Chat user resource name, URL-encoded (users%2F123)", "schema": { "type": "string" } } ], "responses": { "204": { "description": "No content" }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/blockers": { "get": { "operationId": "getBlockers", "summary": "Blockers across the standups the caller can see", "description": "Any signed-in caller. Needs the “See blockers” permission (`blockers.view`).", "x-permission": "blockers.view", "tags": [ "Blockers" ], "parameters": [ { "name": "status", "in": "query", "required": false, "description": "Which blockers", "schema": { "default": "open", "type": "string", "enum": [ "open", "acknowledged", "resolved", "all" ] } }, { "name": "standupId", "in": "query", "required": false, "description": "One standup only", "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, { "name": "owner", "in": "query", "required": false, "description": "Owner’s userName", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BlockerList" } } } }, "400": { "description": "Invalid input; `error.field` names it", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/blockers/{id}/acknowledge": { "post": { "operationId": "postBlockersIdAcknowledge", "summary": "Acknowledge a blocker you are tagged on", "description": "A signed-in person with a Chat identity; the operator token cannot act as one.", "tags": [ "Blockers" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Blocker id", "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BlockerAcknowledged" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Conflicts with the current state", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/blockers/{id}/update": { "post": { "operationId": "postBlockersIdUpdate", "summary": "Add an update to a blocker", "description": "A signed-in person with a Chat identity; the operator token cannot act as one.", "tags": [ "Blockers" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Blocker id", "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BlockerUpdateBody" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BlockerUpdated" } } } }, "400": { "description": "Invalid input; `error.field` names it", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Conflicts with the current state", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/blockers/{id}/resolve": { "post": { "operationId": "postBlockersIdResolve", "summary": "Resolve a blocker", "description": "A signed-in person with a Chat identity; the operator token cannot act as one.", "tags": [ "Blockers" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Blocker id", "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BlockerResolved" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Conflicts with the current state", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/people": { "get": { "operationId": "getPeople", "summary": "Everyone on the rosters the caller manages", "description": "Admins, and managers of the standup or person concerned. Needs the “See the team” permission (`people.view`).", "x-permission": "people.view", "tags": [ "People" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Team" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/templates": { "get": { "operationId": "getTemplates", "summary": "Standup templates", "description": "Any signed-in caller.", "tags": [ "Standups" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Templates" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/spaces": { "get": { "operationId": "getSpaces", "summary": "Chat spaces the app is in", "description": "Workspace admins and the operator token. Needs the “Create standups” permission (`standups.create`).", "x-permission": "standups.create", "tags": [ "Standups" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Spaces" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Google Chat did not answer", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/spaces/{name}/members": { "get": { "operationId": "getSpacesNameMembers", "summary": "Human members of a Chat space", "description": "Workspace admins and the operator token. Needs the “Create standups” permission (`standups.create`).", "x-permission": "standups.create", "tags": [ "Standups" ], "parameters": [ { "name": "name", "in": "path", "required": true, "description": "Space resource name, URL-encoded (spaces%2FAAAA)", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SpaceMembers" } } } }, "400": { "description": "Invalid input; `error.field` names it", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Google Chat did not answer", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/me/standups": { "get": { "operationId": "getMeStandups", "summary": "My standups and how today is going", "description": "Any signed-in caller.", "tags": [ "Me" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MyStandups" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/me/submissions": { "get": { "operationId": "getMeSubmissions", "summary": "My recent answers", "description": "Any signed-in caller.", "tags": [ "Me" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "description": "How many, newest first", "schema": { "default": 10, "type": "integer", "minimum": 1, "maximum": 50 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MySubmissions" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/me/skip": { "post": { "operationId": "postMeSkip", "summary": "Skip today for one standup", "description": "A signed-in person with a Chat identity; the operator token cannot act as one.", "tags": [ "Me" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SkipBody" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Skipped" } } } }, "400": { "description": "Invalid input; `error.field` names it", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Conflicts with the current state", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Not available on this server", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/me/schedule": { "get": { "operationId": "getMeSchedule", "summary": "My days on each standup, policies and upcoming days", "description": "A signed-in person with a Chat identity; the operator token cannot act as one.", "tags": [ "Schedules" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Schedule" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Conflicts with the current state", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Not available on this server", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "patch": { "operationId": "patchMeSchedule", "summary": "Set my days on a standup", "description": "A signed-in person with a Chat identity; the operator token cannot act as one.", "tags": [ "Schedules" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WorkingDaysBody" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Schedule" } } } }, "400": { "description": "Invalid input; `error.field` names it", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Conflicts with the current state", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Not available on this server", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/me/overrides": { "post": { "operationId": "postMeOverrides", "summary": "Mark my days off or extra working days", "description": "A signed-in person with a Chat identity; the operator token cannot act as one.", "tags": [ "Schedules" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OverrideBody" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScheduleChange" } } } }, "400": { "description": "Invalid input; `error.field` names it", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Conflicts with the current state", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Not available on this server", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/me/overrides/{date}": { "delete": { "operationId": "deleteMeOverridesDate", "summary": "Withdraw a day or a pending request", "description": "A signed-in person with a Chat identity; the operator token cannot act as one.", "tags": [ "Schedules" ], "parameters": [ { "name": "date", "in": "path", "required": true, "description": "YYYY-MM-DD", "schema": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScheduleChange" } } } }, "400": { "description": "Invalid input; `error.field` names it", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Conflicts with the current state", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Not available on this server", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/people/{userName}/schedule": { "get": { "operationId": "getPeopleUserNameSchedule", "summary": "Someone’s days and upcoming days", "description": "Admins, and managers of the standup or person concerned. Needs the “Manage schedules” permission (`schedules.manage`).", "x-permission": "schedules.manage", "tags": [ "Schedules" ], "parameters": [ { "name": "userName", "in": "path", "required": true, "description": "Chat user resource name, URL-encoded (users%2F123)", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Schedule" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Not available on this server", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "patch": { "operationId": "patchPeopleUserNameSchedule", "summary": "Set someone’s days on a standup", "description": "Admins, and managers of the standup or person concerned. Needs the “Manage schedules” permission (`schedules.manage`).", "x-permission": "schedules.manage", "tags": [ "Schedules" ], "parameters": [ { "name": "userName", "in": "path", "required": true, "description": "Chat user resource name, URL-encoded (users%2F123)", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WorkingDaysBody" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Schedule" } } } }, "400": { "description": "Invalid input; `error.field` names it", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Not available on this server", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/people/{userName}/overrides": { "post": { "operationId": "postPeopleUserNameOverrides", "summary": "Mark someone’s days off or extra working days", "description": "Admins, and managers of the standup or person concerned. Needs the “Manage schedules” permission (`schedules.manage`).", "x-permission": "schedules.manage", "tags": [ "Schedules" ], "parameters": [ { "name": "userName", "in": "path", "required": true, "description": "Chat user resource name, URL-encoded (users%2F123)", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OverrideBody" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScheduleChange" } } } }, "400": { "description": "Invalid input; `error.field` names it", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Not available on this server", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/people/{userName}/overrides/{date}": { "delete": { "operationId": "deletePeopleUserNameOverridesDate", "summary": "Withdraw someone’s day", "description": "Admins, and managers of the standup or person concerned. Needs the “Manage schedules” permission (`schedules.manage`).", "x-permission": "schedules.manage", "tags": [ "Schedules" ], "parameters": [ { "name": "userName", "in": "path", "required": true, "description": "Chat user resource name, URL-encoded (users%2F123)", "schema": { "type": "string" } }, { "name": "date", "in": "path", "required": true, "description": "YYYY-MM-DD", "schema": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScheduleChange" } } } }, "400": { "description": "Invalid input; `error.field` names it", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Not available on this server", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/requests": { "get": { "operationId": "getRequests", "summary": "Time-off requests waiting for a decision", "description": "Admins, and managers of the standup or person concerned. Needs the “Manage schedules” permission (`schedules.manage`).", "x-permission": "schedules.manage", "tags": [ "Schedules" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TimeOffRequests" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Not available on this server", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/requests/{id}/approve": { "post": { "operationId": "postRequestsIdApprove", "summary": "Approve a request", "description": "Admins, and managers of the standup or person concerned. Needs the “Manage schedules” permission (`schedules.manage`).", "x-permission": "schedules.manage", "tags": [ "Schedules" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Request ids, comma-separated (one request can span several dates)", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DecisionBody" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Decision" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Conflicts with the current state", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Not available on this server", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/requests/{id}/decline": { "post": { "operationId": "postRequestsIdDecline", "summary": "Decline a request", "description": "Admins, and managers of the standup or person concerned. Needs the “Manage schedules” permission (`schedules.manage`).", "x-permission": "schedules.manage", "tags": [ "Schedules" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Request ids, comma-separated", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DecisionBody" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Decision" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Conflicts with the current state", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Not available on this server", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/edit-requests": { "get": { "operationId": "getEditRequests", "summary": "Requests to edit answers after the deadline, waiting for a decision", "description": "Admins, and managers of the standup or person concerned. Needs the “Configure standups” permission (`standups.configure`).", "x-permission": "standups.configure", "tags": [ "Runs" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EditRequests" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Not available on this server", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/edit-requests/{id}/approve": { "post": { "operationId": "postEditRequestsIdApprove", "summary": "Let someone edit their answers until midnight", "description": "Admins, and managers of the standup or person concerned. Needs the “Configure standups” permission (`standups.configure`).", "x-permission": "standups.configure", "tags": [ "Runs" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Edit request id", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DecisionBody" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Decision" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Conflicts with the current state", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Not available on this server", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/edit-requests/{id}/decline": { "post": { "operationId": "postEditRequestsIdDecline", "summary": "Decline a request to edit answers", "description": "Admins, and managers of the standup or person concerned. Needs the “Configure standups” permission (`standups.configure`).", "x-permission": "standups.configure", "tags": [ "Runs" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Edit request id", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DecisionBody" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Decision" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Conflicts with the current state", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Not available on this server", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/standups/{id}/question-polls": { "get": { "operationId": "getStandupsIdQuestionPolls", "summary": "Polls with questions sent to this standup, newest first", "description": "Any signed-in caller. Needs the “See standups” permission (`standups.view`).", "x-permission": "standups.view", "tags": [ "Polls" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Standup id", "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuestionPolls" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Not available on this server", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "post": { "operationId": "postStandupsIdQuestionPolls", "summary": "Send a poll with questions to the standup’s roster", "description": "Admins, and managers of the standup or person concerned. Needs the “Configure standups” permission (`standups.configure`).", "x-permission": "standups.configure", "tags": [ "Polls" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Standup id", "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PollDraft" } } } }, "responses": { "201": { "description": "Created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuestionPoll" } } } }, "400": { "description": "Invalid input; `error.field` names it", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Not available on this server", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/question-polls/{id}": { "get": { "operationId": "getQuestionPollsId", "summary": "One poll, with results when the caller may see them", "description": "Any signed-in caller. Needs the “See standups” permission (`standups.view`).", "x-permission": "standups.view", "tags": [ "Polls" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Poll id", "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuestionPoll" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Not available on this server", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/question-polls/{id}/close": { "post": { "operationId": "postQuestionPollsIdClose", "summary": "Close a poll now", "description": "Admins, and managers of the standup or person concerned. Needs the “Configure standups” permission (`standups.configure`).", "x-permission": "standups.configure", "tags": [ "Polls" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Poll id", "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuestionPoll" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Conflicts with the current state", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Not available on this server", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/question-polls/{id}/export.csv": { "get": { "operationId": "getQuestionPollsIdExportCsv", "summary": "A poll’s answers as CSV, without names on an anonymous poll", "description": "Admins, and managers of the standup or person concerned. Needs the “Configure standups” permission (`standups.configure`).", "x-permission": "standups.configure", "tags": [ "Polls" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Poll id", "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } } ], "responses": { "200": { "description": "OK", "content": { "text/csv": { "schema": { "type": "string" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Not available on this server", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/settings": { "get": { "operationId": "getSettings", "summary": "Workspace settings", "description": "Workspace admins and the operator token. Needs the “Manage settings” permission (`settings.manage`).", "x-permission": "settings.manage", "tags": [ "Settings" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Settings" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "patch": { "operationId": "patchSettings", "summary": "Change workspace settings", "description": "Workspace admins and the operator token. Needs the “Manage settings” permission (`settings.manage`).", "x-permission": "settings.manage", "tags": [ "Settings" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SettingsPatch" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Settings" } } } }, "400": { "description": "Invalid input; `error.field` names it", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Conflicts with the current state", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/history": { "delete": { "operationId": "deleteHistory", "summary": "Delete every run, submission, blocker and poll", "description": "Workspace admins and the operator token. Needs the “Manage settings” permission (`settings.manage`).", "x-permission": "settings.manage", "tags": [ "Settings" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteHistoryBody" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeletedHistory" } } } }, "400": { "description": "Invalid input; `error.field` names it", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/settings/tokens/{name}": { "post": { "operationId": "postSettingsTokensName", "summary": "Generate a machine token", "description": "Workspace admins and the operator token. Needs the “Manage tokens” permission (`tokens.manage`).", "x-permission": "tokens.manage", "tags": [ "Settings" ], "parameters": [ { "name": "name", "in": "path", "required": true, "description": "Which token", "schema": { "type": "string", "enum": [ "tick", "export", "scim" ] } } ], "responses": { "201": { "description": "Created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GeneratedToken" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "delete": { "operationId": "deleteSettingsTokensName", "summary": "Revoke a machine token", "description": "Workspace admins and the operator token. Needs the “Manage tokens” permission (`tokens.manage`).", "x-permission": "tokens.manage", "tags": [ "Settings" ], "parameters": [ { "name": "name", "in": "path", "required": true, "description": "Which token", "schema": { "type": "string", "enum": [ "tick", "export", "scim" ] } } ], "responses": { "204": { "description": "No content" }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/verify/project": { "post": { "operationId": "postVerifyProject", "summary": "Check the Google Cloud project number", "description": "Workspace admins and the operator token. Needs the “Manage settings” permission (`settings.manage`).", "x-permission": "settings.manage", "tags": [ "Verify" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Verification" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/verify/service-account": { "post": { "operationId": "postVerifyServiceAccount", "summary": "Check the service account against the Chat API", "description": "Workspace admins and the operator token. Needs the “Manage settings” permission (`settings.manage`).", "x-permission": "settings.manage", "tags": [ "Verify" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Verification" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/verify/chat-event": { "post": { "operationId": "postVerifyChatEvent", "summary": "Check that Chat events are arriving", "description": "Workspace admins and the operator token. Needs the “Manage settings” permission (`settings.manage`).", "x-permission": "settings.manage", "tags": [ "Verify" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Verification" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/verify/webhook": { "post": { "operationId": "postVerifyWebhook", "summary": "Send a signed test event to a standup’s webhook", "description": "Admins, and managers of the standup or person concerned. Needs the “Configure standups” permission (`standups.configure`).", "x-permission": "standups.configure", "tags": [ "Verify" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VerifyWebhookBody" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Verification" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/verify/saml": { "post": { "operationId": "postVerifySaml", "summary": "Check the SAML identity provider", "description": "Workspace admins and the operator token. Needs the “Manage sign-in” permission (`sso.manage`).", "x-permission": "sso.manage", "tags": [ "Verify" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Verification" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/verify/dm": { "post": { "operationId": "postVerifyDm", "summary": "Send the caller a test DM", "description": "A signed-in person with a Chat identity; the operator token cannot act as one.", "tags": [ "Verify" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Verification" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/mcp/tokens": { "get": { "operationId": "getMcpTokens", "summary": "MCP tokens (admins see all, others their own)", "description": "Any signed-in caller.", "tags": [ "MCP" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/McpTokens" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "post": { "operationId": "postMcpTokens", "summary": "Create an MCP token", "description": "Any signed-in caller.", "tags": [ "MCP" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateMcpTokenBody" } } } }, "responses": { "201": { "description": "Created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatedMcpToken" } } } }, "400": { "description": "Invalid input; `error.field` names it", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/mcp/tokens/{id}": { "delete": { "operationId": "deleteMcpTokensId", "summary": "Revoke an MCP token", "description": "Any signed-in caller.", "tags": [ "MCP" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Token id", "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } } ], "responses": { "204": { "description": "No content" }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/mcp/activity": { "get": { "operationId": "getMcpActivity", "summary": "Recent MCP tool calls", "description": "Any signed-in caller.", "tags": [ "MCP" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "description": "How many, newest first", "schema": { "default": 50, "type": "integer", "minimum": 1, "maximum": 500 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/McpActivity" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/permissions": { "get": { "operationId": "getPermissions", "summary": "Every permission a role can hold", "description": "Any signed-in caller.", "tags": [ "Roles" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PermissionList" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/roles": { "get": { "operationId": "getRoles", "summary": "Built-in and custom roles, with how many hold each", "description": "Admins, and managers of the standup or person concerned. Needs the “Manage people” permission (`people.manage`).", "x-permission": "people.manage", "tags": [ "Roles" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RoleList" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "post": { "operationId": "postRoles", "summary": "Create a role", "description": "Workspace admins and the operator token. Needs the “Manage roles” permission (`roles.manage`).", "x-permission": "roles.manage", "tags": [ "Roles" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RoleBody" } } } }, "responses": { "201": { "description": "Created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Role" } } } }, "400": { "description": "Invalid input; `error.field` names it", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Conflicts with the current state", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/roles/{id}": { "patch": { "operationId": "patchRolesId", "summary": "Change a custom role", "description": "Workspace admins and the operator token. Needs the “Manage roles” permission (`roles.manage`).", "x-permission": "roles.manage", "tags": [ "Roles" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Role id", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RoleBody" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Role" } } } }, "400": { "description": "Invalid input; `error.field` names it", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Conflicts with the current state", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "delete": { "operationId": "deleteRolesId", "summary": "Delete a custom role nobody holds", "description": "Workspace admins and the operator token. Needs the “Manage roles” permission (`roles.manage`).", "x-permission": "roles.manage", "tags": [ "Roles" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Role id", "schema": { "type": "string" } } ], "responses": { "204": { "description": "No content" }, "400": { "description": "Invalid input; `error.field` names it", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Conflicts with the current state", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/grants": { "get": { "operationId": "getGrants", "summary": "Who holds which role, where the caller can grant", "description": "Admins, and managers of the standup or person concerned. Needs the “Manage people” permission (`people.manage`).", "x-permission": "people.manage", "tags": [ "Roles" ], "parameters": [ { "name": "standupId", "in": "query", "required": false, "description": "Only grants on this standup", "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GrantList" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "post": { "operationId": "postGrants", "summary": "Grant a role across the workspace or on one standup", "description": "Admins, and managers of the standup or person concerned. Needs the “Manage people” permission (`people.manage`).", "x-permission": "people.manage", "tags": [ "Roles" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GrantBody" } } } }, "responses": { "201": { "description": "Created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Grant" } } } }, "400": { "description": "Invalid input; `error.field` names it", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Conflicts with the current state", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/grants/{id}": { "delete": { "operationId": "deleteGrantsId", "summary": "Revoke a grant", "description": "Admins, and managers of the standup or person concerned. Needs the “Manage people” permission (`people.manage`).", "x-permission": "people.manage", "tags": [ "Roles" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Grant id", "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } } ], "responses": { "204": { "description": "No content" }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found, or not visible to the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Conflicts with the current state", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/roles/audit": { "get": { "operationId": "getRolesAudit", "summary": "Every change to roles and grants", "description": "Workspace admins and the operator token. Needs the “Manage roles” permission (`roles.manage`).", "x-permission": "roles.manage", "tags": [ "Roles" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "description": "How many, newest first", "schema": { "default": 100, "type": "integer", "minimum": 1, "maximum": 500 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RoleAudit" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/verify/mcp": { "post": { "operationId": "postVerifyMcp", "summary": "Check the MCP server is on and has tokens", "description": "Workspace admins and the operator token. Needs the “Manage settings” permission (`settings.manage`).", "x-permission": "settings.manage", "tags": [ "Verify" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Verification" } } } }, "401": { "description": "Not signed in, or a bad bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not allowed for this caller, a policy refused it, or a browser request without the CSRF header", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } } }, "components": { "schemas": { "Mood": { "type": "string", "enum": [ "great", "good", "okay", "meh", "struggling" ] }, "Weekday": { "type": "string", "enum": [ "mon", "tue", "wed", "thu", "fri", "sat", "sun" ] }, "TimeOffPolicy": { "type": "string", "enum": [ "self", "approval", "managers" ] }, "McpScope": { "type": "string", "enum": [ "read", "blockers:write", "submit", "schedule", "manage" ] }, "Permission": { "type": "string", "enum": [ "standups.view", "standups.create", "standups.configure", "standups.archive", "standups.delete", "people.view", "people.manage", "schedules.manage", "answers.view", "moods.comments", "blockers.view", "blockers.manage", "reports.view", "export", "settings.manage", "sso.manage", "tokens.manage", "roles.manage" ] }, "Error": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "field": { "type": "string" } }, "required": [ "code", "message" ], "additionalProperties": false } }, "required": [ "error" ], "additionalProperties": false }, "Person": { "type": "object", "properties": { "userName": { "type": "string" }, "displayName": { "type": "string" } }, "required": [ "userName", "displayName" ], "additionalProperties": false }, "AuthMethods": { "type": "object", "properties": { "google": { "type": "boolean" }, "saml": { "type": "boolean" }, "token": { "type": "boolean" } }, "required": [ "google", "saml", "token" ], "additionalProperties": false }, "Me": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "admin", "manager", "member" ] }, "via": { "type": "string", "enum": [ "session", "token" ] }, "tenantId": { "type": "string" }, "user": { "anyOf": [ { "type": "object", "properties": { "userName": { "type": [ "string", "null" ] }, "email": { "type": "string" }, "name": { "type": "string" } }, "required": [ "userName", "email", "name" ], "additionalProperties": false }, { "type": "null" } ] }, "managedStandupIds": { "type": "array", "items": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "permissions": { "type": "object", "properties": { "workspace": { "type": "array", "items": { "$ref": "#/components/schemas/Permission" } }, "standups": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "array", "items": { "$ref": "#/components/schemas/Permission" } } } }, "required": [ "workspace", "standups" ], "additionalProperties": false } }, "required": [ "kind", "via", "tenantId", "user", "managedStandupIds", "permissions" ], "additionalProperties": false }, "StandupSummary": { "type": "object", "properties": { "id": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string" }, "spaceName": { "type": "string" }, "active": { "type": "boolean" }, "schedule": { "type": "object", "properties": { "promptTime": { "type": "string", "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$" }, "deadlineTime": { "type": "string", "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$" }, "timezone": { "type": "string" }, "days": { "type": "array", "items": { "$ref": "#/components/schemas/Weekday" } }, "reminderMinutesBefore": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "promptTime", "deadlineTime", "timezone", "days", "reminderMinutesBefore" ], "additionalProperties": false }, "questions": { "type": "array", "items": { "type": "string" } }, "mood": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "anonymous": { "type": "boolean" } }, "required": [ "enabled", "anonymous" ], "additionalProperties": false }, "digestEnabled": { "type": "boolean" }, "timeOffPolicy": { "$ref": "#/components/schemas/TimeOffPolicy" }, "escalation": { "type": "object", "properties": { "afterDays": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "contact": { "anyOf": [ { "type": "object", "properties": { "userName": { "type": "string" }, "displayName": { "type": [ "string", "null" ] } }, "required": [ "userName", "displayName" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "afterDays", "contact" ], "additionalProperties": false }, "webhook": { "type": "object", "properties": { "configured": { "type": "boolean" } }, "required": [ "configured" ], "additionalProperties": false }, "roster": { "type": "object", "properties": { "group": { "type": [ "string", "null" ] }, "syncedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] } }, "required": [ "group", "syncedAt", "error" ], "additionalProperties": false, "description": "`group` is the Google Group the roster follows, or null when people are added by hand." }, "people": { "type": "object", "properties": { "total": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "mandatory": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "total", "mandatory" ], "additionalProperties": false }, "today": { "type": "object", "properties": { "date": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, "status": { "anyOf": [ { "type": "string", "enum": [ "open", "closed" ] }, { "type": "null" } ] }, "submitted": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "expected": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "missing": { "type": "array", "items": { "$ref": "#/components/schemas/Person" } } }, "required": [ "date", "status", "submitted", "expected", "missing" ], "additionalProperties": false }, "permissions": { "type": "object", "properties": { "manage": { "type": "boolean" } }, "required": [ "manage" ], "additionalProperties": false } }, "required": [ "id", "name", "spaceName", "active", "schedule", "questions", "mood", "digestEnabled", "timeOffPolicy", "escalation", "webhook", "roster", "people", "today", "permissions" ], "additionalProperties": false }, "StandupList": { "type": "object", "properties": { "standups": { "type": "array", "items": { "$ref": "#/components/schemas/StandupSummary" } } }, "required": [ "standups" ], "additionalProperties": false }, "StandupDetail": { "type": "object", "properties": { "id": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string" }, "spaceName": { "type": "string" }, "active": { "type": "boolean" }, "schedule": { "type": "object", "properties": { "promptTime": { "type": "string", "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$" }, "deadlineTime": { "type": "string", "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$" }, "timezone": { "type": "string" }, "days": { "type": "array", "items": { "$ref": "#/components/schemas/Weekday" } }, "reminderMinutesBefore": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "promptTime", "deadlineTime", "timezone", "days", "reminderMinutesBefore" ], "additionalProperties": false }, "questions": { "type": "array", "items": { "type": "string" } }, "mood": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "anonymous": { "type": "boolean" } }, "required": [ "enabled", "anonymous" ], "additionalProperties": false }, "digestEnabled": { "type": "boolean" }, "timeOffPolicy": { "$ref": "#/components/schemas/TimeOffPolicy" }, "escalation": { "type": "object", "properties": { "afterDays": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "contact": { "anyOf": [ { "type": "object", "properties": { "userName": { "type": "string" }, "displayName": { "type": [ "string", "null" ] } }, "required": [ "userName", "displayName" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "afterDays", "contact" ], "additionalProperties": false }, "webhook": { "type": "object", "properties": { "configured": { "type": "boolean" } }, "required": [ "configured" ], "additionalProperties": false }, "roster": { "type": "object", "properties": { "group": { "type": [ "string", "null" ] }, "syncedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "leftSpace": { "type": "array", "items": { "type": "object", "properties": { "userName": { "type": "string" }, "displayName": { "type": "string" }, "at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "userName", "displayName", "at" ], "additionalProperties": false }, "description": "On a roster picked from the space: people taken off for leaving it, until they rejoin or a manager acts." } }, "required": [ "group", "syncedAt", "error", "leftSpace" ], "additionalProperties": false, "description": "`group` is the Google Group the roster follows, or null when people are picked from the space. `syncedAt` and `error` cover either kind of sync." }, "people": { "type": "object", "properties": { "total": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "mandatory": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "total", "mandatory" ], "additionalProperties": false }, "today": { "type": "object", "properties": { "date": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, "status": { "anyOf": [ { "type": "string", "enum": [ "open", "closed" ] }, { "type": "null" } ] }, "submitted": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "expected": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "missing": { "type": "array", "items": { "$ref": "#/components/schemas/Person" } } }, "required": [ "date", "status", "submitted", "expected", "missing" ], "additionalProperties": false }, "permissions": { "type": "object", "properties": { "manage": { "type": "boolean" } }, "required": [ "manage" ], "additionalProperties": false }, "participants": { "type": "array", "items": { "type": "object", "properties": { "userName": { "type": "string" }, "displayName": { "type": "string" }, "mandatory": { "type": "boolean" }, "timezone": { "type": [ "string", "null" ] }, "onVacation": { "type": "boolean" }, "workingDays": { "type": [ "string", "null" ] }, "otherStandups": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "source": { "type": "string", "enum": [ "manual", "group" ] }, "reportingManager": { "description": "Who else approves this person’s days off on this standup; null when nobody beyond its managers.", "type": [ "string", "null" ] }, "reportingManagerName": { "type": [ "string", "null" ] } }, "required": [ "userName", "displayName", "mandatory", "timezone", "onVacation", "workingDays", "otherStandups", "source", "reportingManager", "reportingManagerName" ], "additionalProperties": false } }, "admins": { "type": "array", "items": { "$ref": "#/components/schemas/Person" } }, "keptOff": { "type": "array", "items": { "$ref": "#/components/schemas/Person" }, "description": "Roster-group members taken off by hand; syncs keep them off." } }, "required": [ "id", "name", "spaceName", "active", "schedule", "questions", "mood", "digestEnabled", "timeOffPolicy", "escalation", "webhook", "roster", "people", "today", "permissions", "participants", "admins", "keptOff" ], "additionalProperties": false }, "RunNowResult": { "type": "string", "enum": [ "started", "already_open", "already_closed", "past_deadline", "no_participants" ] }, "CreatedStandup": { "type": "object", "properties": { "id": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string" }, "spaceName": { "type": "string" }, "active": { "type": "boolean" }, "schedule": { "type": "object", "properties": { "promptTime": { "type": "string", "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$" }, "deadlineTime": { "type": "string", "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$" }, "timezone": { "type": "string" }, "days": { "type": "array", "items": { "$ref": "#/components/schemas/Weekday" } }, "reminderMinutesBefore": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "promptTime", "deadlineTime", "timezone", "days", "reminderMinutesBefore" ], "additionalProperties": false }, "questions": { "type": "array", "items": { "type": "string" } }, "mood": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "anonymous": { "type": "boolean" } }, "required": [ "enabled", "anonymous" ], "additionalProperties": false }, "digestEnabled": { "type": "boolean" }, "timeOffPolicy": { "$ref": "#/components/schemas/TimeOffPolicy" }, "escalation": { "type": "object", "properties": { "afterDays": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "contact": { "anyOf": [ { "type": "object", "properties": { "userName": { "type": "string" }, "displayName": { "type": [ "string", "null" ] } }, "required": [ "userName", "displayName" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "afterDays", "contact" ], "additionalProperties": false }, "webhook": { "type": "object", "properties": { "configured": { "type": "boolean" } }, "required": [ "configured" ], "additionalProperties": false }, "roster": { "type": "object", "properties": { "group": { "type": [ "string", "null" ] }, "syncedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "leftSpace": { "type": "array", "items": { "type": "object", "properties": { "userName": { "type": "string" }, "displayName": { "type": "string" }, "at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "userName", "displayName", "at" ], "additionalProperties": false }, "description": "On a roster picked from the space: people taken off for leaving it, until they rejoin or a manager acts." } }, "required": [ "group", "syncedAt", "error", "leftSpace" ], "additionalProperties": false, "description": "`group` is the Google Group the roster follows, or null when people are picked from the space. `syncedAt` and `error` cover either kind of sync." }, "people": { "type": "object", "properties": { "total": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "mandatory": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "total", "mandatory" ], "additionalProperties": false }, "today": { "type": "object", "properties": { "date": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, "status": { "anyOf": [ { "type": "string", "enum": [ "open", "closed" ] }, { "type": "null" } ] }, "submitted": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "expected": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "missing": { "type": "array", "items": { "$ref": "#/components/schemas/Person" } } }, "required": [ "date", "status", "submitted", "expected", "missing" ], "additionalProperties": false }, "permissions": { "type": "object", "properties": { "manage": { "type": "boolean" } }, "required": [ "manage" ], "additionalProperties": false }, "participants": { "type": "array", "items": { "type": "object", "properties": { "userName": { "type": "string" }, "displayName": { "type": "string" }, "mandatory": { "type": "boolean" }, "timezone": { "type": [ "string", "null" ] }, "onVacation": { "type": "boolean" }, "workingDays": { "type": [ "string", "null" ] }, "otherStandups": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "source": { "type": "string", "enum": [ "manual", "group" ] }, "reportingManager": { "description": "Who else approves this person’s days off on this standup; null when nobody beyond its managers.", "type": [ "string", "null" ] }, "reportingManagerName": { "type": [ "string", "null" ] } }, "required": [ "userName", "displayName", "mandatory", "timezone", "onVacation", "workingDays", "otherStandups", "source", "reportingManager", "reportingManagerName" ], "additionalProperties": false } }, "admins": { "type": "array", "items": { "$ref": "#/components/schemas/Person" } }, "keptOff": { "type": "array", "items": { "$ref": "#/components/schemas/Person" }, "description": "Roster-group members taken off by hand; syncs keep them off." }, "template": { "type": [ "string", "null" ] }, "runNow": { "anyOf": [ { "$ref": "#/components/schemas/RunNowResult" }, { "type": "null" } ] } }, "required": [ "id", "name", "spaceName", "active", "schedule", "questions", "mood", "digestEnabled", "timeOffPolicy", "escalation", "webhook", "roster", "people", "today", "permissions", "participants", "admins", "keptOff", "template", "runNow" ], "additionalProperties": false }, "ArchiveResult": { "type": "object", "properties": { "id": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "active": { "type": "boolean" } }, "required": [ "id", "active" ], "additionalProperties": false }, "RunNow": { "type": "object", "properties": { "result": { "$ref": "#/components/schemas/RunNowResult" } }, "required": [ "result" ], "additionalProperties": false }, "Nudged": { "type": "object", "properties": { "nudged": { "type": "array", "items": { "$ref": "#/components/schemas/Person" } } }, "required": [ "nudged" ], "additionalProperties": false }, "RunListItem": { "type": "object", "properties": { "date": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, "status": { "type": "string", "enum": [ "open", "closed" ] }, "submitted": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "expected": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "missing": { "type": "array", "items": { "$ref": "#/components/schemas/Person" } } }, "required": [ "date", "status", "submitted", "expected", "missing" ], "additionalProperties": false }, "RunList": { "type": "object", "properties": { "runs": { "type": "array", "items": { "$ref": "#/components/schemas/RunListItem" } } }, "required": [ "runs" ], "additionalProperties": false }, "AwayReason": { "type": "string", "enum": [ "vacation", "calendar_ooo", "day_off", "off_day", "skipped" ] }, "TodayRun": { "type": "object", "properties": { "date": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, "status": { "anyOf": [ { "type": "string", "enum": [ "open", "closed" ] }, { "type": "null" } ] }, "expected": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "submitted": { "type": "array", "items": { "type": "object", "properties": { "userName": { "type": "string" }, "displayName": { "type": "string" }, "submittedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "late": { "type": "boolean" }, "mood": { "anyOf": [ { "$ref": "#/components/schemas/Mood" }, { "type": "null" } ] } }, "required": [ "userName", "displayName", "submittedAt", "late", "mood" ], "additionalProperties": false } }, "waiting": { "type": "array", "items": { "type": "object", "properties": { "userName": { "type": "string" }, "displayName": { "type": "string" }, "mandatory": { "type": "boolean" }, "remindedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] } }, "required": [ "userName", "displayName", "mandatory", "remindedAt" ], "additionalProperties": false } }, "away": { "type": "array", "items": { "type": "object", "properties": { "userName": { "type": "string" }, "displayName": { "type": "string" }, "reason": { "$ref": "#/components/schemas/AwayReason" }, "reasonLabel": { "type": "string" }, "note": { "type": [ "string", "null" ] } }, "required": [ "userName", "displayName", "reason", "reasonLabel", "note" ], "additionalProperties": false } }, "teamMood": { "type": [ "number", "null" ] } }, "required": [ "date", "status", "expected", "submitted", "waiting", "away", "teamMood" ], "additionalProperties": false }, "Answer": { "type": "object", "properties": { "question": { "type": "string" }, "answer": { "type": "string" } }, "required": [ "question", "answer" ], "additionalProperties": false }, "Submission": { "type": "object", "properties": { "userName": { "type": "string" }, "displayName": { "type": "string" }, "submittedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "editedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] }, "late": { "type": "boolean" }, "mood": { "anyOf": [ { "$ref": "#/components/schemas/Mood" }, { "type": "null" } ] }, "answers": { "type": "array", "items": { "$ref": "#/components/schemas/Answer" } } }, "required": [ "userName", "displayName", "submittedAt", "editedAt", "late", "mood", "answers" ], "additionalProperties": false }, "MoodComment": { "type": "object", "properties": { "person": { "anyOf": [ { "$ref": "#/components/schemas/Person" }, { "type": "null" } ] }, "mood": { "$ref": "#/components/schemas/Mood" }, "comment": { "type": "string" } }, "required": [ "person", "mood", "comment" ], "additionalProperties": false }, "RunDetail": { "type": "object", "properties": { "date": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, "status": { "type": "string", "enum": [ "open", "closed" ] }, "submitted": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "expected": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "missing": { "type": "array", "items": { "$ref": "#/components/schemas/Person" } }, "submissions": { "type": "array", "items": { "$ref": "#/components/schemas/Submission" } }, "teamMood": { "type": [ "number", "null" ] }, "moodComments": { "type": "array", "items": { "$ref": "#/components/schemas/MoodComment" } } }, "required": [ "date", "status", "submitted", "expected", "missing", "submissions", "teamMood" ], "additionalProperties": false }, "WeekPoint": { "type": "object", "properties": { "label": { "type": "string" }, "participationPct": { "type": [ "number", "null" ] }, "mood": { "type": [ "number", "null" ] }, "blockersOpened": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "blockersResolved": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "label", "participationPct", "mood", "blockersOpened", "blockersResolved" ], "additionalProperties": false }, "Insights": { "type": "object", "properties": { "weeks": { "type": "array", "items": { "$ref": "#/components/schemas/WeekPoint" } } }, "required": [ "weeks" ], "additionalProperties": false }, "RosterSynced": { "type": "object", "properties": { "added": { "type": "array", "items": { "type": "string" } }, "removed": { "type": "array", "items": { "type": "string" } }, "skipped": { "type": "array", "items": { "type": "object", "properties": { "email": { "type": "string" }, "reason": { "type": "string" } }, "required": [ "email", "reason" ], "additionalProperties": false } }, "syncedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "added", "removed", "skipped", "syncedAt" ], "additionalProperties": false }, "AddedParticipant": { "type": "object", "properties": { "userName": { "type": "string" }, "displayName": { "type": "string" }, "mandatory": { "type": "boolean" }, "reachable": { "type": "boolean" } }, "required": [ "userName", "displayName", "mandatory", "reachable" ], "additionalProperties": false }, "UpdatedParticipant": { "type": "object", "properties": { "userName": { "type": "string" }, "displayName": { "type": "string" }, "mandatory": { "type": "boolean" }, "onVacation": { "type": "boolean" }, "admin": { "type": "boolean" }, "reportingManager": { "type": [ "string", "null" ] }, "reportingManagerName": { "type": [ "string", "null" ] } }, "required": [ "userName", "displayName", "mandatory", "onVacation", "admin", "reportingManager", "reportingManagerName" ], "additionalProperties": false }, "Blocker": { "type": "object", "properties": { "id": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "standup": { "type": "object", "properties": { "id": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string" } }, "required": [ "id", "name" ], "additionalProperties": false }, "owner": { "$ref": "#/components/schemas/Person" }, "text": { "type": "string" }, "openedDate": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, "resolvedDate": { "anyOf": [ { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, { "type": "null" } ] }, "resolvedBy": { "type": [ "string", "null" ] }, "escalatedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] }, "status": { "type": "string", "enum": [ "open", "acknowledged", "resolved" ] }, "tags": { "type": "array", "items": { "type": "object", "properties": { "userName": { "type": "string" }, "displayName": { "type": "string" }, "acknowledgedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] } }, "required": [ "userName", "displayName", "acknowledgedAt" ], "additionalProperties": false } }, "updates": { "type": "array", "items": { "type": "object", "properties": { "userName": { "type": "string" }, "displayName": { "type": "string" }, "text": { "type": "string" }, "at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "userName", "displayName", "text", "at" ], "additionalProperties": false } } }, "required": [ "id", "standup", "owner", "text", "openedDate", "resolvedDate", "resolvedBy", "escalatedAt", "status", "tags", "updates" ], "additionalProperties": false }, "BlockerList": { "type": "object", "properties": { "blockers": { "type": "array", "items": { "$ref": "#/components/schemas/Blocker" } } }, "required": [ "blockers" ], "additionalProperties": false }, "TeamMember": { "type": "object", "properties": { "userName": { "type": "string" }, "displayName": { "type": "string" }, "email": { "type": [ "string", "null" ] }, "timezone": { "type": [ "string", "null" ] }, "onVacation": { "type": "boolean" }, "workingDays": { "type": [ "string", "null" ] }, "workingDaysLabel": { "type": "string" }, "standups": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string" }, "mandatory": { "type": "boolean" }, "admin": { "type": "boolean" } }, "required": [ "id", "name", "mandatory", "admin" ], "additionalProperties": false } } }, "required": [ "userName", "displayName", "email", "timezone", "onVacation", "workingDays", "workingDaysLabel", "standups" ], "additionalProperties": false }, "Team": { "type": "object", "properties": { "people": { "type": "array", "items": { "$ref": "#/components/schemas/TeamMember" } } }, "required": [ "people" ], "additionalProperties": false }, "Template": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "questions": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ] }, "days": { "type": "array", "items": { "$ref": "#/components/schemas/Weekday" } }, "promptTime": { "type": "string", "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$" }, "deadlineTime": { "type": "string", "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$" }, "moodEnabled": { "type": "boolean" }, "moodAnonymous": { "type": "boolean" }, "digestEnabled": { "type": "boolean" } }, "required": [ "id", "name", "description", "questions", "days", "promptTime", "deadlineTime", "moodEnabled", "moodAnonymous", "digestEnabled" ], "additionalProperties": false }, "Templates": { "type": "object", "properties": { "templates": { "type": "array", "items": { "$ref": "#/components/schemas/Template" } } }, "required": [ "templates" ], "additionalProperties": false }, "Spaces": { "type": "object", "properties": { "spaces": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "displayName": { "type": "string" }, "standups": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string" } }, "required": [ "id", "name" ], "additionalProperties": false } } }, "required": [ "name", "displayName", "standups" ], "additionalProperties": false } } }, "required": [ "spaces" ], "additionalProperties": false }, "WebhookSecret": { "type": "object", "properties": { "secret": { "type": "string" } }, "required": [ "secret" ], "additionalProperties": false }, "SpaceMembers": { "type": "object", "properties": { "members": { "type": "array", "items": { "$ref": "#/components/schemas/Person" } } }, "required": [ "members" ], "additionalProperties": false }, "ManagerCandidates": { "type": "object", "properties": { "managers": { "type": "array", "items": { "$ref": "#/components/schemas/Person" } } }, "required": [ "managers" ], "additionalProperties": false }, "MyStandup": { "type": "object", "properties": { "id": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string" }, "schedule": { "type": "object", "properties": { "promptTime": { "type": "string", "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$" }, "deadlineTime": { "type": "string", "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$" }, "timezone": { "type": "string" }, "days": { "type": "array", "items": { "$ref": "#/components/schemas/Weekday" } } }, "required": [ "promptTime", "deadlineTime", "timezone", "days" ], "additionalProperties": false }, "today": { "anyOf": [ { "type": "string", "enum": [ "submitted", "waiting", "closed" ] }, { "type": "null" } ] }, "progress": { "anyOf": [ { "type": "object", "properties": { "submitted": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "expected": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "submitted", "expected" ], "additionalProperties": false }, { "type": "null" } ] }, "mandatory": { "type": "boolean" }, "onVacation": { "type": "boolean" } }, "required": [ "id", "name", "schedule", "today", "progress", "mandatory", "onVacation" ], "additionalProperties": false }, "LinkedMyStandups": { "type": "object", "properties": { "linked": { "type": "boolean", "const": true }, "timezone": { "type": [ "string", "null" ] }, "chat": { "type": "object", "properties": { "dmUrl": { "type": [ "string", "null" ] } }, "required": [ "dmUrl" ], "additionalProperties": false }, "standups": { "type": "array", "items": { "$ref": "#/components/schemas/MyStandup" } } }, "required": [ "linked", "timezone", "chat", "standups" ], "additionalProperties": false }, "MyStandups": { "anyOf": [ { "type": "object", "properties": { "linked": { "type": "boolean", "const": false }, "standups": { "maxItems": 0, "type": "array", "items": { "$ref": "#/components/schemas/MyStandup" } } }, "required": [ "linked", "standups" ], "additionalProperties": false }, { "$ref": "#/components/schemas/LinkedMyStandups" } ] }, "MySubmissions": { "type": "object", "properties": { "submissions": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, "standupName": { "type": "string" }, "submittedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "editedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] }, "late": { "type": "boolean" }, "mood": { "anyOf": [ { "$ref": "#/components/schemas/Mood" }, { "type": "null" } ] }, "moodComment": { "type": [ "string", "null" ] }, "answers": { "type": "array", "items": { "$ref": "#/components/schemas/Answer" } } }, "required": [ "date", "standupName", "submittedAt", "editedAt", "late", "mood", "moodComment", "answers" ], "additionalProperties": false } } }, "required": [ "submissions" ], "additionalProperties": false }, "Skipped": { "type": "object", "properties": { "result": { "type": "string", "const": "skipped" }, "date": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" } }, "required": [ "result", "date" ], "additionalProperties": false }, "MySettings": { "type": "object", "properties": { "timezone": { "type": [ "string", "null" ] }, "onVacation": { "type": "boolean" } }, "required": [ "timezone", "onVacation" ], "additionalProperties": false }, "Override": { "type": "object", "properties": { "id": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "userName": { "type": "string" }, "displayName": { "type": "string" }, "date": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, "working": { "type": "boolean" }, "reason": { "type": "string" }, "status": { "type": "string", "enum": [ "active", "pending", "declined", "expired", "withdrawn" ] }, "label": { "type": "string" }, "setBy": { "type": "string" }, "channel": { "type": "string", "enum": [ "chat", "console", "api" ] }, "decidedBy": { "type": [ "string", "null" ] }, "decisionNote": { "type": [ "string", "null" ] }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "id", "userName", "displayName", "date", "working", "reason", "status", "label", "setBy", "channel", "decidedBy", "decisionNote", "createdAt" ], "additionalProperties": false }, "Schedule": { "type": "object", "properties": { "userName": { "type": "string" }, "displayName": { "type": "string" }, "workingDays": { "description": "Deprecated: days differ per standup, so read `standups`.", "type": [ "string", "null" ] }, "workingDaysLabel": { "type": "string", "description": "Deprecated, with `workingDays`." }, "standups": { "type": "array", "items": { "type": "object", "properties": { "standupId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string" }, "days": { "type": "array", "items": { "$ref": "#/components/schemas/Weekday" }, "description": "The standup’s own days: the default." }, "workingDays": { "type": [ "string", "null" ] }, "workingDaysLabel": { "type": "string" }, "timeOffPolicy": { "$ref": "#/components/schemas/TimeOffPolicy" } }, "required": [ "standupId", "name", "days", "workingDays", "workingDaysLabel", "timeOffPolicy" ], "additionalProperties": false } }, "policies": { "type": "array", "items": { "type": "object", "properties": { "standupId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string" }, "timeOffPolicy": { "$ref": "#/components/schemas/TimeOffPolicy" } }, "required": [ "standupId", "name", "timeOffPolicy" ], "additionalProperties": false } }, "overrides": { "type": "array", "items": { "$ref": "#/components/schemas/Override" } } }, "required": [ "userName", "displayName", "workingDays", "workingDaysLabel", "standups", "policies", "overrides" ], "additionalProperties": false }, "ScheduleChange": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true }, "status": { "type": "string", "enum": [ "active", "pending" ] }, "message": { "type": "string" } }, "required": [ "ok", "status", "message" ], "additionalProperties": false }, "TimeOffRequests": { "type": "object", "properties": { "requests": { "type": "array", "items": { "$ref": "#/components/schemas/Override" } } }, "required": [ "requests" ], "additionalProperties": false }, "Decision": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true }, "message": { "type": "string" } }, "required": [ "ok", "message" ], "additionalProperties": false }, "EditRequest": { "type": "object", "properties": { "id": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "standupId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "standupName": { "type": "string" }, "date": { "type": "string" }, "userName": { "type": "string" }, "displayName": { "type": "string" }, "reason": { "type": [ "string", "null" ] }, "askedAt": { "type": "string" }, "answeredAt": { "type": "string" }, "until": { "type": "string" } }, "required": [ "id", "standupId", "standupName", "date", "userName", "displayName", "reason", "askedAt", "answeredAt", "until" ], "additionalProperties": false }, "EditRequests": { "type": "object", "properties": { "requests": { "type": "array", "items": { "$ref": "#/components/schemas/EditRequest" } } }, "required": [ "requests" ], "additionalProperties": false }, "PollQuestionType": { "type": "string", "enum": [ "short", "long", "dropdown", "single", "multiple" ] }, "PollResultsFor": { "type": "string", "enum": [ "everyone", "managers" ] }, "PollQuestion": { "type": "object", "properties": { "text": { "type": "string" }, "type": { "$ref": "#/components/schemas/PollQuestionType" }, "required": { "type": "boolean" }, "options": { "type": "array", "items": { "type": "string" } } }, "required": [ "text", "type", "required", "options" ], "additionalProperties": false }, "PollDraft": { "type": "object", "properties": { "title": { "type": "string" }, "intro": { "type": [ "string", "null" ] }, "questions": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string" }, "type": { "$ref": "#/components/schemas/PollQuestionType" }, "required": { "type": "boolean" }, "options": { "type": "array", "items": { "type": "string" } } }, "required": [ "text", "type" ], "additionalProperties": false } }, "closesAt": { "type": "string", "description": "Local date and time in the standup’s timezone, YYYY-MM-DDTHH:mm, from 15 minutes to 14 days ahead." }, "remindMinutes": { "anyOf": [ { "anyOf": [ { "type": "number", "const": 15 }, { "type": "number", "const": 60 }, { "type": "number", "const": 1440 } ] }, { "type": "null" } ] }, "anonymous": { "type": "boolean" }, "results": { "$ref": "#/components/schemas/PollResultsFor" } }, "required": [ "title", "questions", "closesAt" ], "additionalProperties": false }, "QuestionPollSummary": { "type": "object", "properties": { "id": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "standupId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "title": { "type": "string" }, "from": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "closesAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "closesLabel": { "type": "string" }, "closedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] }, "closedLabel": { "type": [ "string", "null" ] }, "open": { "type": "boolean" }, "anonymous": { "type": "boolean" }, "results": { "$ref": "#/components/schemas/PollResultsFor" }, "asked": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "answered": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "id", "standupId", "title", "from", "createdAt", "closesAt", "closesLabel", "closedAt", "closedLabel", "open", "anonymous", "results", "asked", "answered" ], "additionalProperties": false }, "QuestionPolls": { "type": "object", "properties": { "polls": { "type": "array", "items": { "$ref": "#/components/schemas/QuestionPollSummary" } } }, "required": [ "polls" ], "additionalProperties": false }, "QuestionPoll": { "type": "object", "properties": { "id": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "standupId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "title": { "type": "string" }, "from": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "closesAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "closesLabel": { "type": "string" }, "closedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] }, "closedLabel": { "type": [ "string", "null" ] }, "open": { "type": "boolean" }, "anonymous": { "type": "boolean" }, "results": { "$ref": "#/components/schemas/PollResultsFor" }, "asked": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "answered": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "intro": { "type": [ "string", "null" ] }, "questions": { "type": "array", "items": { "$ref": "#/components/schemas/PollQuestion" } }, "remindAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] }, "outcome": { "anyOf": [ { "type": "object", "properties": { "notAnswered": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ] }, "questions": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string" }, "type": { "$ref": "#/components/schemas/PollQuestionType" }, "answered": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "options": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string" }, "count": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "names": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ] } }, "required": [ "text", "count", "names" ], "additionalProperties": false } }, "answers": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": [ "string", "null" ] }, "text": { "type": "string" } }, "required": [ "name", "text" ], "additionalProperties": false } } }, "required": [ "text", "type", "answered", "options", "answers" ], "additionalProperties": false } } }, "required": [ "notAnswered", "questions" ], "additionalProperties": false }, { "type": "null" } ], "description": "Null unless the caller may see results. Names are null on an anonymous poll." } }, "required": [ "id", "standupId", "title", "from", "createdAt", "closesAt", "closesLabel", "closedAt", "closedLabel", "open", "anonymous", "results", "asked", "answered", "intro", "questions", "remindAt", "outcome" ], "additionalProperties": false }, "Settings": { "type": "object", "properties": { "chat": { "type": "object", "properties": { "audience": { "type": "string" }, "serviceAccount": { "type": "object", "properties": { "set": { "type": "boolean" }, "email": { "type": [ "string", "null" ] }, "clientId": { "type": [ "string", "null" ] } }, "required": [ "set", "email", "clientId" ], "additionalProperties": false } }, "required": [ "audience", "serviceAccount" ], "additionalProperties": false }, "workspace": { "type": "object", "properties": { "defaultTimezone": { "type": "string" }, "calendarOoo": { "type": "boolean" }, "workspaceAdminEmail": { "type": "string" }, "leaveInChat": { "type": "boolean", "description": "Days off and vacation mode shown as people’s Chat status and a Calendar out-of-office event." }, "leaveDeclineMode": { "type": "string", "enum": [ "none", "new", "all" ], "description": "What the out-of-office event does with clashing invites." }, "leaveSyncError": { "anyOf": [ { "type": "object", "properties": { "message": { "type": "string" }, "at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "message", "at" ], "additionalProperties": false }, { "type": "null" } ], "description": "The latest failure writing someone’s leave to Chat or Calendar." }, "spelling": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "dialect": { "type": "string", "enum": [ "en-GB", "en-US" ] }, "words": { "type": "array", "items": { "type": "string" } } }, "required": [ "enabled", "dialect", "words" ], "additionalProperties": false, "description": "Likely typos in Chat answers pointed out once before posting; `words` are never flagged." } }, "required": [ "defaultTimezone", "calendarOoo", "workspaceAdminEmail", "leaveInChat", "leaveDeclineMode", "leaveSyncError", "spelling" ], "additionalProperties": false }, "signIn": { "type": "object", "properties": { "tokenSignIn": { "type": "boolean" }, "google": { "type": "object", "properties": { "clientId": { "type": "string" }, "clientSecret": { "type": "object", "properties": { "set": { "type": "boolean" } }, "required": [ "set" ], "additionalProperties": false }, "on": { "type": "boolean" } }, "required": [ "clientId", "clientSecret", "on" ], "additionalProperties": false }, "saml": { "type": "object", "properties": { "entityId": { "type": "string" }, "ssoUrl": { "type": "string" }, "cert": { "type": "object", "properties": { "set": { "type": "boolean" } }, "required": [ "set" ], "additionalProperties": false }, "adminAttribute": { "type": "string" }, "adminGroup": { "type": "string" }, "on": { "type": "boolean" } }, "required": [ "entityId", "ssoUrl", "cert", "adminAttribute", "adminGroup", "on" ], "additionalProperties": false } }, "required": [ "tokenSignIn", "google", "saml" ], "additionalProperties": false }, "tokens": { "type": "object", "properties": { "tick": { "type": "object", "properties": { "set": { "type": "boolean" } }, "required": [ "set" ], "additionalProperties": false }, "export": { "type": "object", "properties": { "set": { "type": "boolean" } }, "required": [ "set" ], "additionalProperties": false }, "scim": { "type": "object", "properties": { "set": { "type": "boolean" } }, "required": [ "set" ], "additionalProperties": false } }, "required": [ "tick", "export", "scim" ], "additionalProperties": false }, "setup": { "type": "object", "properties": { "complete": { "type": "boolean" }, "chatConfigured": { "type": "boolean" }, "signInConfigured": { "type": "boolean" } }, "required": [ "complete", "chatConfigured", "signInConfigured" ], "additionalProperties": false }, "mcp": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "defaultScopes": { "type": "array", "items": { "$ref": "#/components/schemas/McpScope" } }, "endpoint": { "type": "string" }, "scopes": { "type": "object", "propertyNames": { "$ref": "#/components/schemas/McpScope" }, "additionalProperties": { "type": "string" }, "required": [ "read", "blockers:write", "submit", "schedule", "manage" ] } }, "required": [ "enabled", "defaultScopes", "endpoint", "scopes" ], "additionalProperties": false } }, "required": [ "chat", "workspace", "signIn", "tokens", "setup", "mcp" ], "additionalProperties": false }, "DeletedHistory": { "type": "object", "properties": { "deleted": { "type": "object", "properties": { "runs": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "submissions": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "blockers": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "polls": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "runs", "submissions", "blockers", "polls" ], "additionalProperties": false } }, "required": [ "deleted" ], "additionalProperties": false }, "GeneratedToken": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "tick", "export", "scim" ] }, "token": { "type": "string" } }, "required": [ "name", "token" ], "additionalProperties": false }, "Verification": { "type": "object", "properties": { "state": { "type": "string", "enum": [ "pass", "fail" ] }, "detail": { "type": "string" }, "checkedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "data": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} } }, "required": [ "state", "detail", "checkedAt" ], "additionalProperties": false }, "McpToken": { "type": "object", "properties": { "id": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string" }, "kind": { "type": "string", "enum": [ "personal", "service" ] }, "owner": { "anyOf": [ { "type": "object", "properties": { "userName": { "type": "string" }, "displayName": { "type": [ "string", "null" ] } }, "required": [ "userName", "displayName" ], "additionalProperties": false }, { "type": "null" } ] }, "scopes": { "type": "array", "items": { "$ref": "#/components/schemas/McpScope" } }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "lastUsedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] }, "expiresAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "revokedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] } }, "required": [ "id", "name", "kind", "owner", "scopes", "createdAt", "lastUsedAt", "expiresAt", "revokedAt" ], "additionalProperties": false }, "McpTokens": { "type": "object", "properties": { "tokens": { "type": "array", "items": { "$ref": "#/components/schemas/McpToken" } } }, "required": [ "tokens" ], "additionalProperties": false }, "CreatedMcpToken": { "type": "object", "properties": { "id": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string" }, "kind": { "type": "string", "enum": [ "personal", "service" ] }, "owner": { "anyOf": [ { "type": "object", "properties": { "userName": { "type": "string" }, "displayName": { "type": [ "string", "null" ] } }, "required": [ "userName", "displayName" ], "additionalProperties": false }, { "type": "null" } ] }, "scopes": { "type": "array", "items": { "$ref": "#/components/schemas/McpScope" } }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "lastUsedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] }, "expiresAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "revokedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] }, "secret": { "type": "string" }, "config": { "type": "object", "properties": { "url": { "type": "string" }, "headers": { "type": "object", "properties": { "Authorization": { "type": "string" } }, "required": [ "Authorization" ], "additionalProperties": false } }, "required": [ "url", "headers" ], "additionalProperties": false } }, "required": [ "id", "name", "kind", "owner", "scopes", "createdAt", "lastUsedAt", "expiresAt", "revokedAt", "secret", "config" ], "additionalProperties": false }, "McpActivity": { "type": "object", "properties": { "activity": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "token": { "type": "object", "properties": { "id": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string" } }, "required": [ "id", "name" ], "additionalProperties": false }, "tool": { "type": "string" }, "argsSummary": { "type": "string" }, "ok": { "type": "boolean" }, "at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "id", "token", "tool", "argsSummary", "ok", "at" ], "additionalProperties": false } } }, "required": [ "activity" ], "additionalProperties": false }, "BlockerAcknowledged": { "type": "object", "properties": { "result": { "type": "string", "const": "acked" } }, "required": [ "result" ], "additionalProperties": false }, "BlockerUpdated": { "type": "object", "properties": { "result": { "type": "string", "const": "ok" } }, "required": [ "result" ], "additionalProperties": false }, "BlockerResolved": { "type": "object", "properties": { "result": { "type": "string", "const": "resolved" } }, "required": [ "result" ], "additionalProperties": false }, "StandupPatch": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "promptTime": { "type": "string", "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$" }, "deadlineTime": { "type": "string", "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$" }, "timezone": { "type": "string", "description": "IANA timezone, e.g. Asia/Kolkata" }, "reminderMinutesBefore": { "type": "integer", "minimum": 0, "maximum": 1440 }, "escalateAfterDays": { "type": "integer", "minimum": 1, "maximum": 30 }, "days": { "anyOf": [ { "type": "array", "items": { "$ref": "#/components/schemas/Weekday" } }, { "type": "string" } ], "description": "[\"mon\",\"tue\"] or \"mon,tue\"" }, "webhookUrl": { "description": "https:// URL; empty or null switches the webhook off", "type": [ "string", "null" ] }, "questions": { "minItems": 1, "maxItems": 10, "type": "array", "items": { "type": "string", "maxLength": 200 } }, "moodEnabled": { "type": "boolean" }, "moodAnonymous": { "type": "boolean" }, "digestEnabled": { "type": "boolean" }, "timeOffPolicy": { "$ref": "#/components/schemas/TimeOffPolicy" }, "escalateUserName": { "description": "A participant’s userName; empty or null switches escalation off", "type": [ "string", "null" ] }, "rosterGroup": { "description": "Google Group email the roster follows; empty or null means people are added by hand", "type": [ "string", "null" ] } }, "additionalProperties": false }, "CreateStandup": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "promptTime": { "type": "string", "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$" }, "deadlineTime": { "type": "string", "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$" }, "timezone": { "type": "string", "description": "IANA timezone, e.g. Asia/Kolkata" }, "reminderMinutesBefore": { "type": "integer", "minimum": 0, "maximum": 1440 }, "escalateAfterDays": { "type": "integer", "minimum": 1, "maximum": 30 }, "days": { "anyOf": [ { "type": "array", "items": { "$ref": "#/components/schemas/Weekday" } }, { "type": "string" } ], "description": "[\"mon\",\"tue\"] or \"mon,tue\"" }, "webhookUrl": { "description": "https:// URL; empty or null switches the webhook off", "type": [ "string", "null" ] }, "questions": { "minItems": 1, "maxItems": 10, "type": "array", "items": { "type": "string", "maxLength": 200 } }, "moodEnabled": { "type": "boolean" }, "moodAnonymous": { "type": "boolean" }, "digestEnabled": { "type": "boolean" }, "timeOffPolicy": { "$ref": "#/components/schemas/TimeOffPolicy" }, "escalateUserName": { "description": "A participant’s userName; empty or null switches escalation off", "type": [ "string", "null" ] }, "rosterGroup": { "description": "Google Group email the roster follows; empty or null means people are added by hand", "type": [ "string", "null" ] }, "spaceName": { "type": "string", "format": "starts_with", "pattern": "^spaces\\/.*" }, "templateId": { "type": [ "string", "null" ] }, "participants": { "type": "array", "items": { "type": "object", "properties": { "userName": { "type": "string", "format": "starts_with", "pattern": "^users\\/.*" }, "displayName": { "type": "string", "minLength": 1, "maxLength": 200 }, "mandatory": { "type": "boolean" } }, "required": [ "userName", "displayName" ], "additionalProperties": false } }, "admins": { "type": "array", "items": { "type": "object", "properties": { "userName": { "type": "string", "format": "starts_with", "pattern": "^users\\/.*" }, "displayName": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "userName", "displayName" ], "additionalProperties": false } }, "runNow": { "type": "boolean" } }, "required": [ "name", "spaceName" ], "additionalProperties": false }, "AddParticipant": { "type": "object", "properties": { "userName": { "type": "string", "format": "starts_with", "pattern": "^users\\/.*" }, "displayName": { "type": "string", "minLength": 1, "maxLength": 200 }, "mandatory": { "type": "boolean" } }, "required": [ "userName", "displayName" ], "additionalProperties": false }, "UpdateParticipant": { "type": "object", "properties": { "mandatory": { "type": "boolean" }, "onVacation": { "type": "boolean" }, "admin": { "type": "boolean" }, "reportingManager": { "anyOf": [ { "type": "string", "format": "starts_with", "pattern": "^users\\/.*" }, { "type": "null" } ], "description": "Must already manage a standup, and not be this person. null clears it." } }, "additionalProperties": false }, "BlockerUpdateBody": { "type": "object", "properties": { "text": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "text" ], "additionalProperties": false }, "SkipBody": { "type": "object", "properties": { "standupId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "reason": { "type": "string", "minLength": 1, "maxLength": 150 } }, "required": [ "standupId", "reason" ], "additionalProperties": false }, "MyPatch": { "type": "object", "properties": { "timezone": { "type": [ "string", "null" ] }, "onVacation": { "type": "boolean" } }, "additionalProperties": false }, "WorkingDaysBody": { "type": "object", "properties": { "workingDays": { "type": "string" }, "standupId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "additionalProperties": false }, "OverrideBody": { "type": "object", "properties": { "date": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, "dates": { "maxItems": 31, "type": "array", "items": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" } }, "from": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, "to": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, "working": { "type": "boolean" }, "reason": { "type": "string" } }, "additionalProperties": false }, "DecisionBody": { "type": "object", "properties": { "note": { "type": "string" } }, "additionalProperties": false }, "SettingsPatch": { "type": "object", "properties": { "calendarOoo": { "type": "boolean" }, "leaveInChat": { "type": "boolean" }, "leaveDeclineMode": { "type": "string", "enum": [ "none", "new", "all" ] }, "spellingEnabled": { "type": "boolean" }, "spellingDialect": { "type": "string", "enum": [ "en-GB", "en-US" ] }, "spellingWords": { "type": "string", "description": "One word or phrase per line." }, "tokenSignIn": { "type": "boolean" }, "setupComplete": { "type": "boolean" }, "mcpEnabled": { "type": "boolean" }, "chatAudience": { "type": "string" }, "serviceAccountJson": { "type": [ "string", "null" ] }, "defaultTimezone": { "type": "string" }, "workspaceAdminEmail": { "type": "string" }, "oauthClientId": { "type": "string" }, "oauthClientSecret": { "type": [ "string", "null" ] }, "samlIdpEntityId": { "type": "string" }, "samlIdpSsoUrl": { "type": "string" }, "samlIdpCert": { "type": "string" }, "samlAdminAttribute": { "type": "string" }, "samlAdminGroup": { "type": "string" }, "mcpDefaultScopes": { "type": "string" } }, "additionalProperties": false }, "DeleteHistoryBody": { "type": "object", "properties": { "confirm": { "type": "string", "const": "DELETE HISTORY" } }, "required": [ "confirm" ], "additionalProperties": false }, "DeleteStandupBody": { "type": "object", "properties": { "confirm": { "type": "string" } }, "required": [ "confirm" ], "additionalProperties": false }, "VerifyWebhookBody": { "type": "object", "properties": { "standupId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "standupId" ], "additionalProperties": false }, "CreateMcpTokenBody": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 200 }, "kind": { "type": "string", "enum": [ "personal", "service" ] }, "scopes": { "type": "array", "items": { "$ref": "#/components/schemas/McpScope" } } }, "required": [ "name" ], "additionalProperties": false }, "PermissionList": { "type": "object", "properties": { "permissions": { "type": "array", "items": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/Permission" }, "label": { "type": "string" }, "description": { "type": "string" }, "workspaceOnly": { "type": "boolean" } }, "required": [ "id", "label", "description", "workspaceOnly" ], "additionalProperties": false } } }, "required": [ "permissions" ], "additionalProperties": false }, "Role": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "permissions": { "type": "array", "items": { "$ref": "#/components/schemas/Permission" } }, "builtIn": { "type": "boolean" }, "grantable": { "type": "boolean" }, "workspaceOnly": { "type": "boolean" }, "grants": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "id", "name", "description", "permissions", "builtIn", "grantable", "workspaceOnly", "grants" ], "additionalProperties": false }, "RoleList": { "type": "object", "properties": { "roles": { "type": "array", "items": { "$ref": "#/components/schemas/Role" } } }, "required": [ "roles" ], "additionalProperties": false }, "RoleBody": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 40 }, "description": { "type": "string", "maxLength": 200 }, "permissions": { "minItems": 1, "type": "array", "items": { "$ref": "#/components/schemas/Permission" } } }, "required": [ "name", "permissions" ], "additionalProperties": false }, "Grant": { "type": "object", "properties": { "id": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "email": { "type": "string" }, "displayName": { "type": "string" }, "role": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "name" ], "additionalProperties": false }, "standup": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string" } }, "required": [ "id", "name" ], "additionalProperties": false }, { "type": "null" } ] }, "grantedBy": { "type": "string" }, "grantedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "id", "email", "displayName", "role", "standup", "grantedBy", "grantedAt" ], "additionalProperties": false }, "GrantList": { "type": "object", "properties": { "grants": { "type": "array", "items": { "$ref": "#/components/schemas/Grant" } } }, "required": [ "grants" ], "additionalProperties": false }, "GrantBody": { "type": "object", "properties": { "email": { "type": "string" }, "displayName": { "type": "string", "maxLength": 200 }, "role": { "type": "string" }, "standupId": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "email", "role" ], "additionalProperties": false }, "RoleAudit": { "type": "object", "properties": { "entries": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "actor": { "type": "string" }, "action": { "type": "string" }, "summary": { "type": "string" } }, "required": [ "id", "at", "actor", "action", "summary" ], "additionalProperties": false } } }, "required": [ "entries" ], "additionalProperties": false } }, "securitySchemes": { "bearer": { "type": "http", "scheme": "bearer", "description": "The operator token, while token sign-in is on." }, "session": { "type": "apiKey", "in": "cookie", "name": "asyncup_sess", "description": "A Google or SAML sign-in session." } } } }