{"items":[{"type":"link","label":"Rosterfy API Documentation","link":"/api-docs/openapi","routeSlug":"/api-docs/openapi","content":{"contentType":"overview","meta":{"name":"Rosterfy API Documentation"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"openapi.json","url":"/_bundle/api-docs/openapi.json?download"},{"kind":"download","label":"openapi.yaml","url":"/_bundle/api-docs/openapi.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[]},{"title":"Languages","titleTranslationKey":"languages.title","children":[{"kind":"languages","options":[{"key":"curl","title":"curl","lang":"curl"},{"key":"javascript","title":"JavaScript","lang":"JavaScript"},{"key":"node","title":"Node.js","lang":"Node.js"},{"key":"python","title":"Python","lang":"Python"},{"key":"java","title":"Java","lang":"Java"},{"key":"csharp","title":"C#","lang":"C#"},{"key":"php","title":"PHP","lang":"PHP"},{"key":"go","title":"Go","lang":"Go"},{"key":"ruby","title":"Ruby","lang":"Ruby"},{"key":"r","title":"R","lang":"R"},{"key":"payload","title":"Payload","lang":"Payload"}]}]},{"title":"Servers","titleTranslationKey":"servers.title","children":[{"kind":"servers","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example","description":"Your account's subdomain - the first part of the address you sign in to Rosterfy on."},"domain":{"default":"rosterfy.com","description":"The rest of that address. rosterfy.com unless your account is on a regional deployment, in which case use the domain you sign in on."}}}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"Rosterfy API Documentation (2.0.0)","showPageActions":true},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":"A guide to using the Rosterfy REST API."}],"sectionId":"/api-docs/openapi"}],"sectionId":"/api-docs/openapi"}]}]}},{"type":"group","label":"Authentication","link":"/api-docs/openapi/authentication","routeSlug":"/api-docs/openapi/authentication","items":[{"label":"Request an access token","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/authentication/requestanaccesstoken","routeSlug":"/api-docs/openapi/authentication/requestanaccesstoken","metadata":{"seo":{"title":"Request an access token","description":"Exchanges a set of client credentials and a user's sign-in details for an access token.Every other endpoint in this API expects the result in anAuthorization: Bearer <access_token> header, so this is the first call an integrationmakes."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"requestAnAccessToken","name":"Request an access token","isWebhook":false,"pointer":"/paths/~1api~1v2~1oauth~1token/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Request an access token","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchanges a set of client credentials and a user's sign-in details for an access token."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Every other endpoint in this API expects the result in an"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header, so this is the first call an integration"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"makes."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You need a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" before you can call it. The client id is the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of one of your personal access clients - see the listing endpoint below. Rosterfy"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"issues the matching secret; no endpoint returns it."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The token is issued for the user whose "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"username"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"password"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" you send, and it carries"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"exactly that user's access. Use a dedicated integration user rather than a person's own"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"login, so the integration keeps working when people come and go and so its activity is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"distinguishable in the audit trail."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the lifetime in seconds - 2592000, or 30 days. The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"refresh_token"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returned"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"alongside it lasts longer than the access token and can be exchanged for a new one by"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"calling this endpoint again with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"grant_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"refresh_token"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", sending"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"refresh_token"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in place of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"username"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"password"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Refresh before the access token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"expires rather than after; once it has lapsed there is nothing to refresh and you are back"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"to a full credential exchange."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The body may be sent as JSON or as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"application/x-www-form-urlencoded"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Both are accepted"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and both return JSON."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Treat the access token as a credential in its own right. It is a bearer token: anything"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"holding it has the user's access for as long as it lives, so store it the way you would"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"store the password you exchanged for it, and never put it in a URL or a log."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_252","exampleIds":["paths/~1api~1v2~1oauth~1token/post/requestBody/content/application~1json/examples/password","paths/~1api~1v2~1oauth~1token/post/requestBody/content/application~1json/examples/refresh"]}},"schemaId":"schema_252","exampleIds":["paths/~1api~1v2~1oauth~1token/post/requestBody/content/application~1json/examples/password","paths/~1api~1v2~1oauth~1token/post/requestBody/content/application~1json/examples/refresh"],"pointer":"/paths/~1api~1v2~1oauth~1token/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/oauth/token","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"schema_252","exampleIds":["paths/~1api~1v2~1oauth~1token/post/requestBody/content/application~1json/examples/password","paths/~1api~1v2~1oauth~1token/post/requestBody/content/application~1json/examples/refresh"]}},"responseCodes":["200","400","401"],"pointer":"/api/v2/oauth/token","href":"authentication/requestanaccesstoken","openApiOperationId":"requestAnAccessToken","summary":"Request an access token"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_252","exampleIds":["paths/~1api~1v2~1oauth~1token/post/requestBody/content/application~1json/examples/password","paths/~1api~1v2~1oauth~1token/post/requestBody/content/application~1json/examples/refresh"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_252","exampleIds":["paths/~1api~1v2~1oauth~1token/post/requestBody/content/application~1json/examples/password","paths/~1api~1v2~1oauth~1token/post/requestBody/content/application~1json/examples/refresh"]}},"examples":[{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"A new access token.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_253","exampleIds":["paths/~1api~1v2~1oauth~1token/post/responses/200/content/application~1json/examples/issued"]}},"schemaId":"schema_253","exampleIds":["paths/~1api~1v2~1oauth~1token/post/responses/200/content/application~1json/examples/issued"]},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The request is not a grant this endpoint can process - an unknown "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"grant_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or one whose required fields are missing."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"exampleIds":["paths/~1api~1v2~1oauth~1token/post/responses/400/content/application~1json/examples/unsupported_grant_type"]}},"exampleIds":["paths/~1api~1v2~1oauth~1token/post/responses/400/content/application~1json/examples/unsupported_grant_type"]},{"code":"401","description":"The credentials were rejected. This covers both halves of the exchange - the client id and secret, and the user details - and does not say which was wrong.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"exampleIds":["paths/~1api~1v2~1oauth~1token/post/responses/401/content/application~1json/examples/invalid_credentials"]}},"exampleIds":["paths/~1api~1v2~1oauth~1token/post/responses/401/content/application~1json/examples/invalid_credentials"]}],"pointer":"/paths/~1api~1v2~1oauth~1token/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_253","exampleIds":["paths/~1api~1v2~1oauth~1token/post/responses/200/content/application~1json/examples/issued"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_253","exampleIds":["paths/~1api~1v2~1oauth~1token/post/responses/200/content/application~1json/examples/issued"]}}},{"code":"400","exampleIds":["paths/~1api~1v2~1oauth~1token/post/responses/400/content/application~1json/examples/unsupported_grant_type"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"exampleIds":["paths/~1api~1v2~1oauth~1token/post/responses/400/content/application~1json/examples/unsupported_grant_type"]}}},{"code":"401","exampleIds":["paths/~1api~1v2~1oauth~1token/post/responses/401/content/application~1json/examples/invalid_credentials"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"exampleIds":["paths/~1api~1v2~1oauth~1token/post/responses/401/content/application~1json/examples/invalid_credentials"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/authentication/requestanaccesstoken"}],"panels":[]}]},"httpPath":"/api/v2/oauth/token"},{"label":"List your personal access clients","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/authentication/listyourpersonalaccessclients","routeSlug":"/api-docs/openapi/authentication/listyourpersonalaccessclients","metadata":{"seo":{"title":"List your personal access clients","description":"Returns the personal access clients registered against the authenticated user. Apersonal access client is the client_id half of the credentials the token endpointexchanges for an access token, and id here is that client_id."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listYourPersonalAccessClients","name":"List your personal access clients","isWebhook":false,"pointer":"/paths/~1api~1v2~1oauth~1clients/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List your personal access clients","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the personal access clients registered against the authenticated user. A"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"personal access client is the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" half of the credentials the token endpoint"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"exchanges for an access token, and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" here is that "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The listing is scoped to the caller and to nobody else: it returns the clients that"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"caller registered, not every client in the account, and there is no parameter that"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"widens it. Clients that have been withdrawn are left out, so an entry disappearing from"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"this list means its credentials no longer work."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response is a flat array. It carries no pagination envelope and takes no filter,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"sort or page parameters, so the whole set comes back in one call however many there are."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"No client secret is returned, here or anywhere else in the API. Ask Rosterfy for the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"secret that goes with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" you hold."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1oauth~1clients/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/oauth/clients","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/oauth/clients","href":"authentication/listyourpersonalaccessclients","openApiOperationId":"listYourPersonalAccessClients","summary":"List your personal access clients"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_255"}},"schemaId":"schema_255"}],"pointer":"/paths/~1api~1v2~1oauth~1clients/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_255","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_255"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/authentication/listyourpersonalaccessclients"}],"panels":[]}]},"httpPath":"/api/v2/oauth/clients"},{"label":"Register a personal access client","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/authentication/registerapersonalaccessclient","routeSlug":"/api-docs/openapi/authentication/registerapersonalaccessclient","metadata":{"seo":{"title":"Register a personal access client","description":"Registers a new personal access client against the authenticated user and returns it.The id on the response is the client_id the token endpoint expects."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"registerAPersonalAccessClient","name":"Register a personal access client","isWebhook":false,"pointer":"/paths/~1api~1v2~1oauth~1clients/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Register a personal access client","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Registers a new personal access client against the authenticated user and returns it."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on the response is the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" the token endpoint expects."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The client belongs to the caller. It is not shared with the rest of the account, and it"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"carries the caller's own access - a token issued through it can reach whatever that user"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"can reach, so register the client as the user whose access the integration should have."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response does not include the client secret"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and no endpoint returns it"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"afterwards. Ask Rosterfy for the secret that goes with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" this call"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"returns; until you have it, the client cannot complete a token exchange."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1oauth~1clients/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_256"}},"schemaId":"schema_256","pointer":"/paths/~1api~1v2~1oauth~1clients/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/oauth/clients","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_256"}},"responseCodes":["201","404"],"pointer":"/api/v2/oauth/clients","href":"authentication/registerapersonalaccessclient","openApiOperationId":"registerAPersonalAccessClient","summary":"Register a personal access client"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_256","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_256"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_257"}},"schemaId":"schema_257"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1oauth~1clients/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_257","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_257"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/authentication/registerapersonalaccessclient"}],"panels":[]}]},"httpPath":"/api/v2/oauth/clients"}],"content":{"contentType":"group","meta":{"name":"Authentication"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Authentication","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v2/oauth/token","summary":"Request an access token","prefix":{"name":"post","color":"post"},"badges":[],"link":"/authentication/requestanaccesstoken","deprecated":false},{"title":"/api/v2/oauth/clients","summary":"List your personal access clients","prefix":{"name":"get","color":"get"},"badges":[],"link":"/authentication/listyourpersonalaccessclients","deprecated":false},{"title":"/api/v2/oauth/clients","summary":"Register a personal access client","prefix":{"name":"post","color":"post"},"badges":[],"link":"/authentication/registerapersonalaccessclient","deprecated":false}]}]}]}]}},{"type":"group","label":"Me Module","link":"/api-docs/openapi/me-module","routeSlug":"/api-docs/openapi/me-module","items":[{"label":"Get current user","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/me-module/getcurrentuser","routeSlug":"/api-docs/openapi/me-module/getcurrentuser","metadata":{"seo":{"title":"Get current user","description":"Returns everything a client needs about the signed-in user in a single call: who they are,what they are allowed to do, and how their experience should be configured. This is thecall to make immediately after authenticating."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getCurrentUser","name":"Get current user","isWebhook":false,"pointer":"/paths/~1api~1v2~1user~1me/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get current user","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns everything a client needs about the signed-in user in a single call: who they are,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"what they are allowed to do, and how their experience should be configured. This is the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"call to make immediately after authenticating."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the profile itself, including any custom attributes the account has defined,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"which appear as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"custom_*"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" keys alongside the standard ones. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the same data"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"formatted for display - dates written out, phone numbers and addresses composed, coded"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"values resolved to their labels - so a client can render fields without reimplementing the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"account's formatting rules. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the user type they belong to, which carries the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"shift limits and rules applied to them."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"permissions"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" states what the user may do, as a flat map of permission keys to booleans. It"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"is large for an administrator and short for an ordinary portal user, and the example below"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"shows a representative selection rather than the full set. Test for the specific keys you"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"care about rather than iterating the map, and treat an absent key as not granted."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"checkpoint"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"checkpoint_permissions"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" describe the onboarding stage the user has"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"reached and what that stage unlocks. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"settings"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" holds their personal preferences, such as"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"locale and timezone, which should be preferred over any account default."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The remaining keys are small signals: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"socials"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" lists the social accounts linked to the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"profile, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"is_primary_account"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" says whether they are signed in to the account that owns"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"their record rather than a related one, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"has_account_roles"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" says whether they hold any"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"administrative role, and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"messaging_user_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is present only where messaging is enabled."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Because the response contains the caller's own personal data, treat it accordingly - do not"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"log it wholesale or cache it anywhere shared."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1user~1me/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/user/me","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/v2/user/me","href":"me-module/getcurrentuser","openApiOperationId":"getCurrentUser","summary":"Get current user"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_259"}},"schemaId":"schema_259"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1user~1me/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_259","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_259"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/me-module/getcurrentuser"}],"panels":[]}]},"httpPath":"/api/v2/user/me"},{"label":"Get current account configuration","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/me-module/getcurrentaccountconfiguration","routeSlug":"/api-docs/openapi/me-module/getcurrentaccountconfiguration","metadata":{"seo":{"title":"Get current account configuration","description":"Returns the configuration a client needs in order to present the organisation correctly:how the account identifies itself, the settings that shape the experience, the wording ituses for everyday concepts, and the locales it offers. Which account answers is determinedby the subdomain the request is made against, so no identifier is passed."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getCurrentAccountConfiguration","name":"Get current account configuration","isWebhook":false,"pointer":"/paths/~1api~1v2~1account~1data/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get current account configuration","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the configuration a client needs in order to present the organisation correctly:"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"how the account identifies itself, the settings that shape the experience, the wording it"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"uses for everyday concepts, and the locales it offers. Which account answers is determined"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"by the subdomain the request is made against, so no identifier is passed."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response has five parts. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"account"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the organisation itself - its identifier, its"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"parent if it sits under one, its status and a set of capability flags a client uses to"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"decide what to show. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"settings"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the account's configuration as key/value pairs, keyed by"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"section:name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" string. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"terms"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the account's own vocabulary, so an organisation that"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"calls its people \"Members\" rather than \"Volunteers\" is reflected here and a client should"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"take its labels from this block rather than hard-coding them. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"locales"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" lists the languages"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"offered. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"extras"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" carries client-side integration configuration."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"settings"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" block is large and account-specific - a configured organisation returns"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"several hundred entries - so the example shows a representative selection rather than the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"full set. Read the keys you need by name and ignore the rest; entries are added over time"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and a key being absent means the account has not set it."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Despite being grouped with the current-user endpoints, this describes the organisation and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"not the caller. Nothing in the response varies by user."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1account~1data/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/account/data","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/account/data","href":"me-module/getcurrentaccountconfiguration","openApiOperationId":"getCurrentAccountConfiguration","summary":"Get current account configuration"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_260"}},"schemaId":"schema_260"}],"pointer":"/paths/~1api~1v2~1account~1data/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_260","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_260"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/me-module/getcurrentaccountconfiguration"}],"panels":[]}]},"httpPath":"/api/v2/account/data"},{"label":"Get my statistics","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/me-module/getmystatistics","routeSlug":"/api-docs/openapi/me-module/getmystatistics","metadata":{"seo":{"title":"Get my statistics","description":"Returns the headline activity totals for the signed-in user - the sort of figures avolunteer portal shows on a dashboard, such as events attended, shifts worked, hourscontributed and the current reward point balance. Each entry carries a stable code tokey off, a display label already rendered in the account's own terminology, the valueitself, and an icon hint the portal uses."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getMyStatistics","name":"Get my statistics","isWebhook":false,"pointer":"/paths/~1api~1v2~1me~1stats/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get my statistics","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the headline activity totals for the signed-in user - the sort of figures a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"volunteer portal shows on a dashboard, such as events attended, shifts worked, hours"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contributed and the current reward point balance. Each entry carries a stable "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"key off, a display "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"label"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" already rendered in the account's own terminology, the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"value"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"itself, and an "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"icon"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" hint the portal uses."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Which totals come back is a per-account choice, so the set of codes is not fixed and an"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"account that has selected none receives an empty array. Treat "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" as the contract and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ignore any code you do not recognise rather than relying on position. Totals are computed"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"on read and briefly cached, so a figure can lag a change made moments earlier."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1me~1stats/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/me/stats","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/me/stats","href":"me-module/getmystatistics","openApiOperationId":"getMyStatistics","summary":"Get my statistics"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_261"}},"schemaId":"schema_261"}],"pointer":"/paths/~1api~1v2~1me~1stats/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_261","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_261"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/me-module/getmystatistics"}],"panels":[]}]},"httpPath":"/api/v2/me/stats"},{"label":"List my training","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/me-module/listmytraining","routeSlug":"/api-docs/openapi/me-module/listmytraining","metadata":{"seo":{"title":"List my training","description":"Returns the published training modules that are relevant to the signed-in user: those theyhave been assigned, plus any module the organisation has made elective so that anyone maystart it. Modules the user has been explicitly exempted from are left out, as are modulesthat have not been published. Training shared down from a parent organisation is includedalongside the account's own."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listMyTraining","name":"List my training","isWebhook":false,"pointer":"/paths/~1api~1v2~1me~1training/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List my training","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the published training modules that are relevant to the signed-in user: those they"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"have been assigned, plus any module the organisation has made elective so that anyone may"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"start it. Modules the user has been explicitly exempted from are left out, as are modules"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"that have not been published. Training shared down from a parent organisation is included"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"alongside the account's own."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Each row is the training module itself rather than the user's progress against it. To see"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"where the user has got to, filter on "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"current_user.status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", whose values are "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"COMPLETE"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INCOMPLETE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filter[0][attr]=current_user.status&filter[0][value]=INCOMPLETE"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"for everything still outstanding."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The listing is only paginated when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is supplied. Without it every match is returned"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"as a flat array rather than in the paged envelope."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"per_page","in":"query","schemaId":"schema_262","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of results to return per page. The higher the number the longer the request may take."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is highly recommended to use this to avoid timeouts as your data grows."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate results."},"children":[]}]}]}]},{"name":"page","in":"query","schemaId":"schema_263","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The page of results to return. Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"per_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"results. If not specified, defaults to 1."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response's next_page_url will be null if there are no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"more pages."},"children":[]}]}]}]},{"name":"filter","in":"query","schemaId":"schema_264","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A filter to apply to the results. Declared as an array of objects, where each object"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contains an attr (attribute code), operator and value key. Examples:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=name&filter[0][operator]=like&filter[0][value]=luke"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=id&filter[0][operator]=>&filter[0][value]=265"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the filters documentation for more details on how to use this."},"children":[]}]}]}],"example":null},{"name":"sort_by","in":"query","schemaId":"schema_265","description":"The field to sort the results by. No ordering is applied unless you specify one, so\nrow order is not guaranteed. Always send it when paging through a list, otherwise\nrecords can repeat or be missed between pages.\nExample: id","example":null},{"name":"sort_order","in":"query","schemaId":"schema_266","description":"The direction to sort the results by. Can be 'asc' or 'desc', default is 'asc'.","example":null},{"name":"_locale","in":"query","schemaId":"schema_267","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The locale to use for the response. This primarily affects the results of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contain human-readable labels and terms, as well as locale-specific date formats.,"},"children":[]}]}]}]},{"name":"extras","in":"query","schemaId":"schema_268","description":"A list of extras to include in the response. These are objects or arrays that are not part of\nthe model's primary attributes, such as stats and counts.\nFor fast responses, avoid requesting them if you don't need them. "}],"pointer":"/paths/~1api~1v2~1me~1training/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1me~1training/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/me/training","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[{"name":"per_page","in":"query","required":false,"schemaId":"schema_262"},{"name":"page","in":"query","required":false,"schemaId":"schema_263"},{"name":"filter","in":"query","required":false,"schemaId":"schema_264"},{"name":"sort_by","in":"query","required":false,"schemaId":"schema_265"},{"name":"sort_order","in":"query","required":false,"schemaId":"schema_266"},{"name":"_locale","in":"query","required":false,"schemaId":"schema_267"},{"name":"extras","in":"query","required":false,"schemaId":"schema_268"}],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/me/training","href":"me-module/listmytraining","openApiOperationId":"listMyTraining","summary":"List my training"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_269"}},"schemaId":"schema_269"}],"pointer":"/paths/~1api~1v2~1me~1training/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_269","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_269"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/me-module/listmytraining"}],"panels":[]}]},"httpPath":"/api/v2/me/training"},{"label":"List my events","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/me-module/listmyevents","routeSlug":"/api-docs/openapi/me-module/listmyevents","metadata":{"seo":{"title":"List my events","description":"Returns the events the signed-in user has a record against - anything they have appliedfor, been rostered onto, attended or registered interest in. An event the user has noinvolvement with is never returned, so this is the volunteer's own history and upcomingschedule rather than a catalogue of what the organisation is running."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listMyEvents","name":"List my events","isWebhook":false,"pointer":"/paths/~1api~1v2~1me~1event/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List my events","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the events the signed-in user has a record against - anything they have applied"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"for, been rostered onto, attended or registered interest in. An event the user has no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"involvement with is never returned, so this is the volunteer's own history and upcoming"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"schedule rather than a catalogue of what the organisation is running."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Rows are events, not shifts. To work with the individual shifts inside an event, use the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"shift endpoints rather than reading them from here."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Events that have not been published are excluded unless the caller also administers events,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"so an ordinary portal user and an administrator can get different counts for the same"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"query."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The listing is only paginated when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is supplied. Without it every match is returned"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"as a flat array rather than in the paged envelope."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"status","in":"query","schemaId":"schema_270","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Narrow the list by the user's involvement. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"active"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returns only"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"events where they hold a live place, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"demand"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" only events still looking for people. Any"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"other value is ignored and the full list is returned."},"children":[]}]}]}]},{"name":"per_page","in":"query","schemaId":"schema_262","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of results to return per page. The higher the number the longer the request may take."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is highly recommended to use this to avoid timeouts as your data grows."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate results."},"children":[]}]}]}]},{"name":"page","in":"query","schemaId":"schema_263","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The page of results to return. Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"per_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"results. If not specified, defaults to 1."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response's next_page_url will be null if there are no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"more pages."},"children":[]}]}]}]},{"name":"filter","in":"query","schemaId":"schema_264","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A filter to apply to the results. Declared as an array of objects, where each object"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contains an attr (attribute code), operator and value key. Examples:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=name&filter[0][operator]=like&filter[0][value]=luke"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=id&filter[0][operator]=>&filter[0][value]=265"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the filters documentation for more details on how to use this."},"children":[]}]}]}],"example":null},{"name":"sort_by","in":"query","schemaId":"schema_265","description":"The field to sort the results by. No ordering is applied unless you specify one, so\nrow order is not guaranteed. Always send it when paging through a list, otherwise\nrecords can repeat or be missed between pages.\nExample: id","example":null},{"name":"sort_order","in":"query","schemaId":"schema_266","description":"The direction to sort the results by. Can be 'asc' or 'desc', default is 'asc'.","example":null},{"name":"_locale","in":"query","schemaId":"schema_267","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The locale to use for the response. This primarily affects the results of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contain human-readable labels and terms, as well as locale-specific date formats.,"},"children":[]}]}]}]},{"name":"extras","in":"query","schemaId":"schema_271","description":"A list of extras to include in the response. These are objects or arrays that are not part of\nthe model's primary attributes, such as stats and counts.\nFor fast responses, avoid requesting them if you don't need them. "},{"name":"with","in":"query","schemaId":"schema_272","description":"A list of relations to include in the response. May be single records or collections.\nIt is often more efficient to retrieve this way, to avoid follow-up API calls."}],"pointer":"/paths/~1api~1v2~1me~1event/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1me~1event/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/me/event","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[{"name":"status","in":"query","required":false,"schemaId":"schema_270"},{"name":"per_page","in":"query","required":false,"schemaId":"schema_262"},{"name":"page","in":"query","required":false,"schemaId":"schema_263"},{"name":"filter","in":"query","required":false,"schemaId":"schema_264"},{"name":"sort_by","in":"query","required":false,"schemaId":"schema_265"},{"name":"sort_order","in":"query","required":false,"schemaId":"schema_266"},{"name":"_locale","in":"query","required":false,"schemaId":"schema_267"},{"name":"extras","in":"query","required":false,"schemaId":"schema_271"},{"name":"with","in":"query","required":false,"schemaId":"schema_272"}],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/me/event","href":"me-module/listmyevents","openApiOperationId":"listMyEvents","summary":"List my events"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_273"}},"schemaId":"schema_273"}],"pointer":"/paths/~1api~1v2~1me~1event/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_273","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_273"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/me-module/listmyevents"}],"panels":[]}]},"httpPath":"/api/v2/me/event"},{"label":"List my inventory items","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/me-module/listmyinventoryitems","routeSlug":"/api-docs/openapi/me-module/listmyinventoryitems","metadata":{"seo":{"title":"List my inventory items","description":"Returns the inventory the signed-in user holds - uniforms, equipment, passes, awards andanything else the organisation tracks against a person. Rows come back in the order theuser has arranged them."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listMyInventoryItems","name":"List my inventory items","isWebhook":false,"pointer":"/paths/~1api~1v2~1me~1inventory~1item/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List my inventory items","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the inventory the signed-in user holds - uniforms, equipment, passes, awards and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"anything else the organisation tracks against a person. Rows come back in the order the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"user has arranged them."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint answers two different questions, and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"assigned_only"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" chooses which. Left at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"its default it returns the user's "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"allocations"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": one row per item actually issued to"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"them, carrying the allocation's own serial number, expiry and collection state. Set it to"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and it returns the "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"catalogue"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instead: the published items the user is eligible for,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"whether or not they hold one yet."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The two modes return different shapes, so read "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"assigned_only"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" as a switch between two"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"resources rather than as a filter. The example below is the default, allocation shape."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Allocations that have already been collected, or whose expiry has passed, are left out of"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the default listing."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The listing is only paginated when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is supplied. Without it every match is returned"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"as a flat array rather than in the paged envelope."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"assigned_only","in":"query","schemaId":"schema_274","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return the user's own allocations ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", the default) or"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the catalogue of items they are eligible for ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). The two return different shapes."},"children":[]}]}]}]},{"name":"per_page","in":"query","schemaId":"schema_262","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of results to return per page. The higher the number the longer the request may take."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is highly recommended to use this to avoid timeouts as your data grows."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate results."},"children":[]}]}]}]},{"name":"page","in":"query","schemaId":"schema_263","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The page of results to return. Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"per_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"results. If not specified, defaults to 1."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response's next_page_url will be null if there are no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"more pages."},"children":[]}]}]}]},{"name":"filter","in":"query","schemaId":"schema_264","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A filter to apply to the results. Declared as an array of objects, where each object"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contains an attr (attribute code), operator and value key. Examples:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=name&filter[0][operator]=like&filter[0][value]=luke"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=id&filter[0][operator]=>&filter[0][value]=265"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the filters documentation for more details on how to use this."},"children":[]}]}]}],"example":null},{"name":"sort_by","in":"query","schemaId":"schema_265","description":"The field to sort the results by. No ordering is applied unless you specify one, so\nrow order is not guaranteed. Always send it when paging through a list, otherwise\nrecords can repeat or be missed between pages.\nExample: id","example":null},{"name":"sort_order","in":"query","schemaId":"schema_266","description":"The direction to sort the results by. Can be 'asc' or 'desc', default is 'asc'.","example":null},{"name":"_locale","in":"query","schemaId":"schema_267","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The locale to use for the response. This primarily affects the results of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contain human-readable labels and terms, as well as locale-specific date formats.,"},"children":[]}]}]}]}],"pointer":"/paths/~1api~1v2~1me~1inventory~1item/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1me~1inventory~1item/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/me/inventory/item","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[{"name":"assigned_only","in":"query","required":false,"schemaId":"schema_274"},{"name":"per_page","in":"query","required":false,"schemaId":"schema_262"},{"name":"page","in":"query","required":false,"schemaId":"schema_263"},{"name":"filter","in":"query","required":false,"schemaId":"schema_264"},{"name":"sort_by","in":"query","required":false,"schemaId":"schema_265"},{"name":"sort_order","in":"query","required":false,"schemaId":"schema_266"},{"name":"_locale","in":"query","required":false,"schemaId":"schema_267"}],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/me/inventory/item","href":"me-module/listmyinventoryitems","openApiOperationId":"listMyInventoryItems","summary":"List my inventory items"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_275"}},"schemaId":"schema_275"}],"pointer":"/paths/~1api~1v2~1me~1inventory~1item/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_275","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_275"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/me-module/listmyinventoryitems"}],"panels":[]}]},"httpPath":"/api/v2/me/inventory/item"},{"label":"Get my reward point balance","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/me-module/getmyrewardpointbalance","routeSlug":"/api-docs/openapi/me-module/getmyrewardpointbalance","metadata":{"seo":{"title":"Get my reward point balance","description":"Returns the signed-in user's current reward point balance as a single number. The balanceis the net of every points transaction on the account - points awarded for attendingshifts, completing training or any other earning rule the organisation has configured,less anything already redeemed."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getMyRewardPointBalance","name":"Get my reward point balance","isWebhook":false,"pointer":"/paths/~1api~1v2~1me~1reward-point~1balance/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get my reward point balance","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the signed-in user's current reward point balance as a single number. The balance"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"is the net of every points transaction on the account - points awarded for attending"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"shifts, completing training or any other earning rule the organisation has configured,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"less anything already redeemed."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The balance is derived on read rather than stored, so it always reflects the transactions"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"recorded at the moment of the call. A user who has never earned or redeemed anything gets"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rather than an error, and so does a user on an account that does not use reward points"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"at all - a zero balance is not a signal that the feature is switched off."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1me~1reward-point~1balance/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/me/reward-point/balance","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/me/reward-point/balance","href":"me-module/getmyrewardpointbalance","openApiOperationId":"getMyRewardPointBalance","summary":"Get my reward point balance"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_276"}},"schemaId":"schema_276"}],"pointer":"/paths/~1api~1v2~1me~1reward-point~1balance/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_276","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_276"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/me-module/getmyrewardpointbalance"}],"panels":[]}]},"httpPath":"/api/v2/me/reward-point/balance"}],"content":{"contentType":"group","meta":{"name":"Me Module"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Me Module","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v2/user/me","summary":"Get current user","prefix":{"name":"get","color":"get"},"badges":[],"link":"/me-module/getcurrentuser","deprecated":false},{"title":"/api/v2/account/data","summary":"Get current account configuration","prefix":{"name":"get","color":"get"},"badges":[],"link":"/me-module/getcurrentaccountconfiguration","deprecated":false},{"title":"/api/v2/me/stats","summary":"Get my statistics","prefix":{"name":"get","color":"get"},"badges":[],"link":"/me-module/getmystatistics","deprecated":false},{"title":"/api/v2/me/training","summary":"List my training","prefix":{"name":"get","color":"get"},"badges":[],"link":"/me-module/listmytraining","deprecated":false},{"title":"/api/v2/me/event","summary":"List my events","prefix":{"name":"get","color":"get"},"badges":[],"link":"/me-module/listmyevents","deprecated":false},{"title":"/api/v2/me/inventory/item","summary":"List my inventory items","prefix":{"name":"get","color":"get"},"badges":[],"link":"/me-module/listmyinventoryitems","deprecated":false},{"title":"/api/v2/me/reward-point/balance","summary":"Get my reward point balance","prefix":{"name":"get","color":"get"},"badges":[],"link":"/me-module/getmyrewardpointbalance","deprecated":false}]}]}]}]}},{"type":"group","label":"User Module","link":"/api-docs/openapi/user-module","routeSlug":"/api-docs/openapi/user-module","items":[{"label":"List users","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/user-module/listusers","routeSlug":"/api-docs/openapi/user-module/listusers","metadata":{"seo":{"title":"List users","description":"Returns the people on your account: their name, contact details, date ofbirth, address, and a value for every custom attribute the account collectsabout a person. The nice block repeats the same values rendered fordisplay - the phone number formatted for its country, the address as onestring, select ids resolved to their labels - so a table can be drawnwithout resolving anything yourself."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listUsers","name":"List users","isWebhook":false,"pointer":"/paths/~1api~1v2~1user/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List users","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the people on your account: their name, contact details, date of"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"birth, address, and a value for every custom attribute the account collects"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"about a person. The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" block repeats the same values rendered for"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"display - the phone number formatted for its country, the address as one"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"string, select ids resolved to their labels - so a table can be drawn"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"without resolving anything yourself."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This is the largest response the API produces. An account with a few"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"hundred people and a normal set of custom attributes runs to megabytes, so"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"page it rather than reading it whole, and filter it if you are looking for"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"someone in particular."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"per_page","in":"query","schemaId":"schema_262","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of results to return per page. The higher the number the longer the request may take."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is highly recommended to use this to avoid timeouts as your data grows."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate results."},"children":[]}]}]}]},{"name":"page","in":"query","schemaId":"schema_263","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The page of results to return. Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"per_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"results. If not specified, defaults to 1."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response's next_page_url will be null if there are no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"more pages."},"children":[]}]}]}]},{"name":"filter","in":"query","schemaId":"schema_264","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A filter to apply to the results. Declared as an array of objects, where each object"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contains an attr (attribute code), operator and value key. Examples:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=name&filter[0][operator]=like&filter[0][value]=luke"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=id&filter[0][operator]=>&filter[0][value]=265"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the filters documentation for more details on how to use this."},"children":[]}]}]}],"example":null},{"name":"sort_by","in":"query","schemaId":"schema_265","description":"The field to sort the results by. No ordering is applied unless you specify one, so\nrow order is not guaranteed. Always send it when paging through a list, otherwise\nrecords can repeat or be missed between pages.\nExample: id","example":null},{"name":"sort_order","in":"query","schemaId":"schema_266","description":"The direction to sort the results by. Can be 'asc' or 'desc', default is 'asc'.","example":null},{"name":"_locale","in":"query","schemaId":"schema_267","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The locale to use for the response. This primarily affects the results of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contain human-readable labels and terms, as well as locale-specific date formats.,"},"children":[]}]}]}]},{"name":"extras","in":"query","schemaId":"schema_277","description":"A list of extras to include in the response. These are objects or arrays that are not part of\nthe model's primary attributes, such as stats and counts.\nFor fast responses, avoid requesting them if you don't need them. "},{"name":"with","in":"query","schemaId":"schema_278","description":"A list of relations to include in the response. May be single records or collections.\nIt is often more efficient to retrieve this way, to avoid follow-up API calls."}],"pointer":"/paths/~1api~1v2~1user/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1user/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/user","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[{"name":"per_page","in":"query","required":false,"schemaId":"schema_262"},{"name":"page","in":"query","required":false,"schemaId":"schema_263"},{"name":"filter","in":"query","required":false,"schemaId":"schema_264"},{"name":"sort_by","in":"query","required":false,"schemaId":"schema_265"},{"name":"sort_order","in":"query","required":false,"schemaId":"schema_266"},{"name":"_locale","in":"query","required":false,"schemaId":"schema_267"},{"name":"extras","in":"query","required":false,"schemaId":"schema_277"},{"name":"with","in":"query","required":false,"schemaId":"schema_278"}],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/user","href":"user-module/listusers","openApiOperationId":"listUsers","summary":"List users"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_279"}},"schemaId":"schema_279"}],"pointer":"/paths/~1api~1v2~1user/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_279","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_279"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/user-module/listusers"}],"panels":[]}]},"httpPath":"/api/v2/user"},{"label":"Create a user","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/user-module/createauser","routeSlug":"/api-docs/openapi/user-module/createauser","metadata":{"seo":{"title":"Create a user","description":"Adds a person to your account and returns the created record. The responsecarries only the fields the create actually set, so it is a smaller objectthan reading the same person back afterwards - read them again if you needthe full record."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createAUser","name":"Create a user","isWebhook":false,"pointer":"/paths/~1api~1v2~1user/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a user","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Adds a person to your account and returns the created record. The response"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"carries only the fields the create actually set, so it is a smaller object"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"than reading the same person back afterwards - read them again if you need"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the full record."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Which fields are required depends on the account."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"first_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"last_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" always are. Whether "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dob"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are required is an account"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"setting, so the same body can be accepted on one account and rejected on"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"another; if you integrate against several, send both."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Custom attributes are sent alongside the fields below, under the codes the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"account defines for them. Creating a person may send them a welcome email,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"depending on how the account is configured."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1user/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_280"}},"schemaId":"schema_280","pointer":"/paths/~1api~1v2~1user/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/user","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_280"}},"responseCodes":["201","404","422"],"pointer":"/api/v2/user","href":"user-module/createauser","openApiOperationId":"createAUser","summary":"Create a user"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_280","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_280"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_281"}},"schemaId":"schema_281"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"},{"code":"422","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_282"}},"schemaId":"schema_282"}],"pointer":"/paths/~1api~1v2~1user/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_281","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_281"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}},{"code":"422","schemaId":"schema_282","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_282"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/user-module/createauser"}],"panels":[]}]},"httpPath":"/api/v2/user"},{"label":"Update many users at once","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/user-module/updatemanyusersatonce","routeSlug":"/api-docs/openapi/user-module/updatemanyusersatonce","metadata":{"seo":{"title":"Update many users at once","description":"Applies one set of changes to many people and returns a token identifyingthe queued job. The work happens in the background, so a 200 means therequest was accepted, not that every record has been updated."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateManyUsersAtOnce","name":"Update many users at once","isWebhook":false,"pointer":"/paths/~1api~1v2~1user/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update many users at once","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Applies one set of changes to many people and returns a token identifying"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the queued job. The work happens in the background, so a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"200"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" means the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"request was accepted, not that every record has been updated."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Choose the people either explicitly or by filter. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"applyTo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"takes the ids in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"applyTo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"all"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" takes everyone your token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"may read, narrowed by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filter"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if you send one and to a single group if you"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"group_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The fields you may change are the ones "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PUT /user/{id}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" accepts"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":","},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"including the account's custom attributes, sent the same way. Two rules"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"differ from the single update. Every field you send is applied to every"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"person selected, so a field left out of the body is the only way to leave it"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"alone - and if you are building a form that offers \"keep existing value\" per"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"field, send that field with a companion "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"<field>:use_default"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"it will be skipped."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Records that fail validation individually are reported against the job"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"rather than rejecting the whole request, so a token can come back for a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"request that ends up changing nothing."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1user/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_283"}},"schemaId":"schema_283","pointer":"/paths/~1api~1v2~1user/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v2/user","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_283"}},"responseCodes":["200","422"],"pointer":"/api/v2/user","href":"user-module/updatemanyusersatonce","openApiOperationId":"updateManyUsersAtOnce","summary":"Update many users at once"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_283","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_283"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_284"}},"schemaId":"schema_284"},{"code":"422","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_285"}},"schemaId":"schema_285"}],"pointer":"/paths/~1api~1v2~1user/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_284","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_284"}}},{"code":"422","schemaId":"schema_285","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_285"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/user-module/updatemanyusersatonce"}],"panels":[]}]},"httpPath":"/api/v2/user"},{"label":"Read a user","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/user-module/readauser","routeSlug":"/api-docs/openapi/user-module/readauser","metadata":{"seo":{"title":"Read a user","description":"Returns one person's record: contact details, date of birth, address,subscription and verification state, and a value for every custom attributethe account collects. The nice block repeats those values rendered fordisplay, and permissions says what your token may go on to do with thisperson."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"readAUser","name":"Read a user","isWebhook":false,"pointer":"/paths/~1api~1v2~1user~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Read a user","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns one person's record: contact details, date of birth, address,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"subscription and verification state, and a value for every custom attribute"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the account collects. The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" block repeats those values rendered for"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"display, and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"permissions"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" says what your token may go on to do with this"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"person."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_286","description":"The ID of the user.","required":true}],"pointer":"/paths/~1api~1v2~1user~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1user~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/user/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_286"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/v2/user/{id}","href":"user-module/readauser","openApiOperationId":"readAUser","summary":"Read a user"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_287"}},"schemaId":"schema_287"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1user~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_287","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_287"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/user-module/readauser"}],"panels":[]}]},"httpPath":"/api/v2/user/{id}"},{"label":"Update a user","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/user-module/updateauser","routeSlug":"/api-docs/openapi/user-module/updateauser","metadata":{"seo":{"title":"Update a user","description":"Updates one person's record and returns it, the same shape as reading itback. Every field is optional, so a body carrying only what changed is safe"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateAUser","name":"Update a user","isWebhook":false,"pointer":"/paths/~1api~1v2~1user~1{id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a user","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Updates one person's record and returns it, the same shape as reading it"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"back. Every field is optional, so a body carrying only what changed is safe"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"fields you leave out keep their current values."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Custom attributes are sent alongside the fields below, under the codes the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"account defines for them. Send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"account_role"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to change the administrative"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"role this person holds on the account; a role your own token may not grant"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"is rejected as a validation error against that field."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_286","description":"The ID of the user.","required":true}],"pointer":"/paths/~1api~1v2~1user~1{id}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1user~1{id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_288"}},"schemaId":"schema_288","pointer":"/paths/~1api~1v2~1user~1{id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v2/user/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_286"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_288"}},"responseCodes":["200","404","422"],"pointer":"/api/v2/user/{id}","href":"user-module/updateauser","openApiOperationId":"updateAUser","summary":"Update a user"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_288","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_288"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_287"}},"schemaId":"schema_287"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"},{"code":"422","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_289"}},"schemaId":"schema_289"}],"pointer":"/paths/~1api~1v2~1user~1{id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_287","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_287"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}},{"code":"422","schemaId":"schema_289","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_289"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/user-module/updateauser"}],"panels":[]}]},"httpPath":"/api/v2/user/{id}"},{"label":"Delete a user","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/user-module/deleteauser","routeSlug":"/api-docs/openapi/user-module/deleteauser","metadata":{"seo":{"title":"Delete a user","description":"Removes a person from the account. The record is soft-deleted rather thanerased, so their history on shifts, training and forms is preserved and thedeletion can be undone in-platform."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteAUser","name":"Delete a user","isWebhook":false,"pointer":"/paths/~1api~1v2~1user~1{id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete a user","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Removes a person from the account. The record is soft-deleted rather than"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"erased, so their history on shifts, training and forms is preserved and the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"deletion can be undone in-platform."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Deleting someone whose permissions other account configuration relies on -"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"a report or a group they created - is refused with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"405"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" naming what"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"stands in the way. That refusal can be overridden by repeating the request"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reference"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" from the response in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"override[]"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", which accepts the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"consequence the message describes."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_286","description":"The ID of the user.","required":true}],"pointer":"/paths/~1api~1v2~1user~1{id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1user~1{id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/v2/user/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_286"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["204","404","405"],"pointer":"/api/v2/user/{id}","href":"user-module/deleteauser","openApiOperationId":"deleteAUser","summary":"Delete a user"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"No content, successful deletion","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"},{"code":"405","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_290"}},"schemaId":"schema_290"}],"pointer":"/paths/~1api~1v2~1user~1{id}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"204","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}},{"code":"405","schemaId":"schema_290","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_290"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/user-module/deleteauser"}],"panels":[]}]},"httpPath":"/api/v2/user/{id}"},{"label":"Add users to groups in bulk","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/user-module/adduserstogroupsinbulk","routeSlug":"/api-docs/openapi/user-module/adduserstogroupsinbulk","metadata":{"seo":{"title":"Add users to groups in bulk","description":"Adds many people to one or more user groups and returns a token identifyingthe queued job. The work happens in the background, so a 200 means therequest was accepted, not that every membership exists yet. People alreadyin a group are skipped rather than duplicated."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"addUsersToGroupsInBulk","name":"Add users to groups in bulk","isWebhook":false,"pointer":"/paths/~1api~1v2~1user~1group~1user/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Add users to groups in bulk","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Adds many people to one or more user groups and returns a token identifying"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the queued job. The work happens in the background, so a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"200"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" means the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"request was accepted, not that every membership exists yet. People already"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"in a group are skipped rather than duplicated."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"entity"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" says what the ids you send refer to, and it is the field that makes"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"this endpoint worth using: with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" you send user ids directly, and with"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the other values you send shift, shift-assignment, event-registration or"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"role-offer-application ids instead and the people attached to those records"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"are the ones added. That is how \"add everyone rostered on this shift to a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"group\" is expressed."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"applyTo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" takes the ids in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"applyTo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"all"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" takes"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"every record of that "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"entity"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" type on the account, narrowed by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filter"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"you send one - so an "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"all"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with no filter is a very wide request, and worth"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"running against the corresponding listing first to see what it selects."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Three of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"entity"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" types are scoped to a parent record through"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"identifiers"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and two of them insist on it: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"event_user"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" requires"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"identifiers.event_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"role_offer_user"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" requires"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"identifiers.role_offer_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", while "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"event_shift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"event_shift_user"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" accept"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"identifiers.event_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"identifiers.shift_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" respectively to narrow the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"selection but do not require them. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"entity"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ignores "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"identifiers"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"entirely."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1user~1group~1user/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_291"}},"schemaId":"schema_291","pointer":"/paths/~1api~1v2~1user~1group~1user/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v2/user/group/user","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_291"}},"responseCodes":["200","422"],"pointer":"/api/v2/user/group/user","href":"user-module/adduserstogroupsinbulk","openApiOperationId":"addUsersToGroupsInBulk","summary":"Add users to groups in bulk"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_291","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_291"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_284"}},"schemaId":"schema_284"},{"code":"422","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_292"}},"schemaId":"schema_292"}],"pointer":"/paths/~1api~1v2~1user~1group~1user/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_284","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_284"}}},{"code":"422","schemaId":"schema_292","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_292"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/user-module/adduserstogroupsinbulk"}],"panels":[]}]},"httpPath":"/api/v2/user/group/user"}],"content":{"contentType":"group","meta":{"name":"User Module"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"User Module","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v2/user","summary":"List users","prefix":{"name":"get","color":"get"},"badges":[],"link":"/user-module/listusers","deprecated":false},{"title":"/api/v2/user","summary":"Create a user","prefix":{"name":"post","color":"post"},"badges":[],"link":"/user-module/createauser","deprecated":false},{"title":"/api/v2/user","summary":"Update many users at once","prefix":{"name":"put","color":"put"},"badges":[],"link":"/user-module/updatemanyusersatonce","deprecated":false},{"title":"/api/v2/user/{id}","summary":"Read a user","prefix":{"name":"get","color":"get"},"badges":[],"link":"/user-module/readauser","deprecated":false},{"title":"/api/v2/user/{id}","summary":"Update a user","prefix":{"name":"put","color":"put"},"badges":[],"link":"/user-module/updateauser","deprecated":false},{"title":"/api/v2/user/{id}","summary":"Delete a user","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/user-module/deleteauser","deprecated":false},{"title":"/api/v2/user/group/user","summary":"Add users to groups in bulk","prefix":{"name":"put","color":"put"},"badges":[],"link":"/user-module/adduserstogroupsinbulk","deprecated":false}]}]}]}]}},{"type":"group","label":"Account Module","link":"/api-docs/openapi/account-module","routeSlug":"/api-docs/openapi/account-module","items":[{"label":"List sub-accounts","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/account-module/listsubaccounts","routeSlug":"/api-docs/openapi/account-module/listsubaccounts","metadata":{"seo":{"title":"List sub-accounts","description":"Returns the sub-accounts sitting directly beneath the one you are signed in to.Neither the account you are calling as nor anything above it is included, andaccounts in a different part of the hierarchy are never returned."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listSubAccounts","name":"List sub-accounts","isWebhook":false,"pointer":"/paths/~1api~1v2~1account/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List sub-accounts","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the sub-accounts sitting directly beneath the one you are signed in to."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Neither the account you are calling as nor anything above it is included, and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"accounts in a different part of the hierarchy are never returned."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Each row carries "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"object.parent_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"object.path"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - a slash-separated chain of"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"account ids from the top of the tree down - so the hierarchy can be rebuilt from"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the listing without further calls."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Results are limited to the sub-accounts you are allowed to see, so two callers in"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the same account can get different rows."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"show_descendant","in":"query","schemaId":"schema_293","description":"Return the whole subtree rather than only the\naccounts one level down. Available when the account allows it."},{"name":"subaccount_selection","in":"query","schemaId":"schema_294","description":"Narrow the results to the sub-accounts\noffered in the account-switching menu. Available when the account allows it."},{"name":"per_page","in":"query","schemaId":"schema_262","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of results to return per page. The higher the number the longer the request may take."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is highly recommended to use this to avoid timeouts as your data grows."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate results."},"children":[]}]}]}]},{"name":"page","in":"query","schemaId":"schema_263","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The page of results to return. Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"per_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"results. If not specified, defaults to 1."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response's next_page_url will be null if there are no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"more pages."},"children":[]}]}]}]},{"name":"filter","in":"query","schemaId":"schema_264","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A filter to apply to the results. Declared as an array of objects, where each object"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contains an attr (attribute code), operator and value key. Examples:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=name&filter[0][operator]=like&filter[0][value]=luke"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=id&filter[0][operator]=>&filter[0][value]=265"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the filters documentation for more details on how to use this."},"children":[]}]}]}],"example":null},{"name":"sort_by","in":"query","schemaId":"schema_265","description":"The field to sort the results by. No ordering is applied unless you specify one, so\nrow order is not guaranteed. Always send it when paging through a list, otherwise\nrecords can repeat or be missed between pages.\nExample: id","example":null},{"name":"sort_order","in":"query","schemaId":"schema_266","description":"The direction to sort the results by. Can be 'asc' or 'desc', default is 'asc'.","example":null},{"name":"_locale","in":"query","schemaId":"schema_267","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The locale to use for the response. This primarily affects the results of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contain human-readable labels and terms, as well as locale-specific date formats.,"},"children":[]}]}]}]},{"name":"extras","in":"query","schemaId":"schema_295","description":"A list of extras to include in the response. These are objects or arrays that are not part of\nthe model's primary attributes, such as stats and counts.\nFor fast responses, avoid requesting them if you don't need them. "},{"name":"with","in":"query","schemaId":"schema_296","description":"A list of relations to include in the response. May be single records or collections.\nIt is often more efficient to retrieve this way, to avoid follow-up API calls."}],"pointer":"/paths/~1api~1v2~1account/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1account/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/account","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[{"name":"show_descendant","in":"query","required":false,"schemaId":"schema_293"},{"name":"subaccount_selection","in":"query","required":false,"schemaId":"schema_294"},{"name":"per_page","in":"query","required":false,"schemaId":"schema_262"},{"name":"page","in":"query","required":false,"schemaId":"schema_263"},{"name":"filter","in":"query","required":false,"schemaId":"schema_264"},{"name":"sort_by","in":"query","required":false,"schemaId":"schema_265"},{"name":"sort_order","in":"query","required":false,"schemaId":"schema_266"},{"name":"_locale","in":"query","required":false,"schemaId":"schema_267"},{"name":"extras","in":"query","required":false,"schemaId":"schema_295"},{"name":"with","in":"query","required":false,"schemaId":"schema_296"}],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/account","href":"account-module/listsubaccounts","openApiOperationId":"listSubAccounts","summary":"List sub-accounts"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_297"}},"schemaId":"schema_297"}],"pointer":"/paths/~1api~1v2~1account/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_297","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_297"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/account-module/listsubaccounts"}],"panels":[]}]},"httpPath":"/api/v2/account"},{"label":"Create a sub-account","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/account-module/createasubaccount","routeSlug":"/api-docs/openapi/account-module/createasubaccount","metadata":{"seo":{"title":"Create a sub-account","description":"Creates a sub-account directly beneath the one you are signed in to. The parent isalways taken from the caller and cannot be set from the request. The response isthe same shape as reading the account, so a follow-up read is not needed."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createASubAccount","name":"Create a sub-account","isWebhook":false,"pointer":"/paths/~1api~1v2~1account/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a sub-account","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Creates a sub-account directly beneath the one you are signed in to. The parent is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"always taken from the caller and cannot be set from the request. The response is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the same shape as reading the account, so a follow-up read is not needed."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Only "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is required. Send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"_options.create_admin"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" together with the four"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"contact_*"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" fields to create the account's first administrator at the same time,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and add "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"_options.send_welcome"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to email them an invitation - without an"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"administrator, nobody can sign in to the new account yet."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Leave "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"create_defaults"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on unless you intend to configure the account from"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"scratch; a sub-account without the default statuses, forms and templates is not"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"usable on its own."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"meta"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is stored whole."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" The object you send replaces the stored one rather"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"than merging into it, so send every key you want to keep."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Creating a sub-account is refused once the account has reached its configured"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"limit on sub-accounts"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and the limit of any account above it applies too, so a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"parent at its own limit blocks the whole branch."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fields beyond the ones below are accepted from callers with elevated access."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The account's own configured attributes are accepted as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"custom_*"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" fields."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The endpoint also accepts a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"recipe"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" file - a blueprint to build the new account"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"from, sent as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"multipart/form-data"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instead of JSON. It is left out of the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"parameters below because a blueprint comes from exporting an existing account,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"which is not part of the published API."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1account/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_298"}},"schemaId":"schema_298","pointer":"/paths/~1api~1v2~1account/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/account","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_298"}},"responseCodes":["201","404"],"pointer":"/api/v2/account","href":"account-module/createasubaccount","openApiOperationId":"createASubAccount","summary":"Create a sub-account"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_298","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_298"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_299"}},"schemaId":"schema_299"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1account/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_299","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_299"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/account-module/createasubaccount"}],"panels":[]}]},"httpPath":"/api/v2/account"},{"label":"Read a sub-account","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/account-module/readasubaccount","routeSlug":"/api-docs/openapi/account-module/readasubaccount","metadata":{"seo":{"title":"Read a sub-account","description":"Returns one account from your own part of the hierarchy: its name, where it sits,its contact and billing details, the domains it answers on, and the featuresettings it has turned on."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"readASubAccount","name":"Read a sub-account","isWebhook":false,"pointer":"/paths/~1api~1v2~1account~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Read a sub-account","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns one account from your own part of the hierarchy: its name, where it sits,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"its contact and billing details, the domains it answers on, and the feature"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"settings it has turned on."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"object.config.active_settings"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" names the settings configured on the account; the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"example below shows a representative handful rather than the whole list. The"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"values themselves are read through the account settings endpoints."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_300","description":"The ID of the account.","required":true}],"pointer":"/paths/~1api~1v2~1account~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1account~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/account/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_300"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/v2/account/{id}","href":"account-module/readasubaccount","openApiOperationId":"readASubAccount","summary":"Read a sub-account"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_299"}},"schemaId":"schema_299"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1account~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_299","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_299"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/account-module/readasubaccount"}],"panels":[]}]},"httpPath":"/api/v2/account/{id}"},{"label":"Update a sub-account","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/account-module/updateasubaccount","routeSlug":"/api-docs/openapi/account-module/updateasubaccount","metadata":{"seo":{"title":"Update a sub-account","description":"Updates an account in your own part of the hierarchy. Every field is optional; arequest with an empty body succeeds and changes nothing."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateASubAccount","name":"Update a sub-account","isWebhook":false,"pointer":"/paths/~1api~1v2~1account~1{id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a sub-account","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Updates an account in your own part of the hierarchy. Every field is optional; a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"request with an empty body succeeds and changes nothing."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"meta"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is stored whole."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" The object you send replaces the stored one rather"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"than merging into it, so an update carrying only "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"meta.publish"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" clears"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"meta.join"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"meta.promote"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"meta.hide_from_new_applicants"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Send every key"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"you want to keep."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint answers in one of two shapes, both with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"200"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Normally it"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"returns the updated account, the same shape as reading it. But a request that"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"carries a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"permissions"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" object differing from the one already stored is handed to a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"background job instead, and the response is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{\"queue\": \"<token>\"}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - nothing has"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"been saved by the time it returns, the rest of the fields in that request are"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"applied in the background too, and the token is not something you can poll. Read"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the account back to confirm the outcome. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"permissions"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" describes what features the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"account itself may use and is not something an ordinary caller can change; sending"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"it still switches the response shape, and it is then ignored."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fields beyond the ones below are accepted from callers with elevated access."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The account's own configured attributes are accepted as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"custom_*"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" fields."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_300","description":"The ID of the account.","required":true}],"pointer":"/paths/~1api~1v2~1account~1{id}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1account~1{id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_301"}},"schemaId":"schema_301","pointer":"/paths/~1api~1v2~1account~1{id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v2/account/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_300"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_301"}},"responseCodes":["200","404"],"pointer":"/api/v2/account/{id}","href":"account-module/updateasubaccount","openApiOperationId":"updateASubAccount","summary":"Update a sub-account"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_301","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_301"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_302"}},"schemaId":"schema_302"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1account~1{id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_302","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_302"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/account-module/updateasubaccount"}],"panels":[]}]},"httpPath":"/api/v2/account/{id}"},{"label":"Delete a sub-account","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/account-module/deleteasubaccount","routeSlug":"/api-docs/openapi/account-module/deleteasubaccount","metadata":{"seo":{"title":"Delete a sub-account","description":"Removes a sub-account. The account and its records are retained rather than erased, but no endpoint restores them, so treat this as final."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteASubAccount","name":"Delete a sub-account","isWebhook":false,"pointer":"/paths/~1api~1v2~1account~1{id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete a sub-account","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Removes a sub-account. The account and its records are retained rather than erased,\nbut no endpoint restores them, so treat this as final."},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_300","description":"The ID of the account.","required":true}],"pointer":"/paths/~1api~1v2~1account~1{id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1account~1{id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/v2/account/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_300"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["204","404"],"pointer":"/api/v2/account/{id}","href":"account-module/deleteasubaccount","openApiOperationId":"deleteASubAccount","summary":"Delete a sub-account"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"No content, successful deletion","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1account~1{id}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"204","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/account-module/deleteasubaccount"}],"panels":[]}]},"httpPath":"/api/v2/account/{id}"},{"label":"List roles","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/account-module/listroles","routeSlug":"/api-docs/openapi/account-module/listroles","metadata":{"seo":{"title":"List roles","description":"Returns the roles belonging to the account you are calling as. Roles an account above this one has marked inheritable are not included here - each account's listing is its own."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listRoles","name":"List roles","isWebhook":false,"pointer":"/paths/~1api~1v2~1account~1role/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List roles","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns the roles belonging to the account you are calling as. Roles an account\nabove this one has marked inheritable are not included here - each account's\nlisting is its own."},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"per_page","in":"query","schemaId":"schema_262","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of results to return per page. The higher the number the longer the request may take."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is highly recommended to use this to avoid timeouts as your data grows."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate results."},"children":[]}]}]}]},{"name":"page","in":"query","schemaId":"schema_263","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The page of results to return. Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"per_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"results. If not specified, defaults to 1."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response's next_page_url will be null if there are no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"more pages."},"children":[]}]}]}]},{"name":"filter","in":"query","schemaId":"schema_264","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A filter to apply to the results. Declared as an array of objects, where each object"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contains an attr (attribute code), operator and value key. Examples:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=name&filter[0][operator]=like&filter[0][value]=luke"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=id&filter[0][operator]=>&filter[0][value]=265"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the filters documentation for more details on how to use this."},"children":[]}]}]}],"example":null},{"name":"sort_by","in":"query","schemaId":"schema_265","description":"The field to sort the results by. No ordering is applied unless you specify one, so\nrow order is not guaranteed. Always send it when paging through a list, otherwise\nrecords can repeat or be missed between pages.\nExample: id","example":null},{"name":"sort_order","in":"query","schemaId":"schema_266","description":"The direction to sort the results by. Can be 'asc' or 'desc', default is 'asc'.","example":null},{"name":"_locale","in":"query","schemaId":"schema_267","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The locale to use for the response. This primarily affects the results of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contain human-readable labels and terms, as well as locale-specific date formats.,"},"children":[]}]}]}]}],"pointer":"/paths/~1api~1v2~1account~1role/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1account~1role/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/account/role","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[{"name":"per_page","in":"query","required":false,"schemaId":"schema_262"},{"name":"page","in":"query","required":false,"schemaId":"schema_263"},{"name":"filter","in":"query","required":false,"schemaId":"schema_264"},{"name":"sort_by","in":"query","required":false,"schemaId":"schema_265"},{"name":"sort_order","in":"query","required":false,"schemaId":"schema_266"},{"name":"_locale","in":"query","required":false,"schemaId":"schema_267"}],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/account/role","href":"account-module/listroles","openApiOperationId":"listRoles","summary":"List roles"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_303"}},"schemaId":"schema_303"}],"pointer":"/paths/~1api~1v2~1account~1role/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_303","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_303"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/account-module/listroles"}],"panels":[]}]},"httpPath":"/api/v2/account/role"},{"label":"Create a role","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/account-module/createarole","routeSlug":"/api-docs/openapi/account-module/createarole","metadata":{"seo":{"title":"Create a role","description":"Creates a role in the account you are calling as. The account is taken from thecaller and cannot be set from the request. The response is the same shape asreading the role, so a follow-up read is not needed."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createARole","name":"Create a role","isWebhook":false,"pointer":"/paths/~1api~1v2~1account~1role/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a role","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Creates a role in the account you are calling as. The account is taken from the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"caller and cannot be set from the request. The response is the same shape as"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"reading the role, so a follow-up read is not needed."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"permissions"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are all required; a request missing any of them"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"comes back as a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"422"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" naming the ones at fault. A "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"permissions"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" object granting"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"more than the caller's own role holds is rejected the same way."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"options"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is stored whole."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" The object you send replaces the stored one rather"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"than merging into it, so send every key you want to keep."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1account~1role/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_304"}},"schemaId":"schema_304","pointer":"/paths/~1api~1v2~1account~1role/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/account/role","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_304"}},"responseCodes":["201","404"],"pointer":"/api/v2/account/role","href":"account-module/createarole","openApiOperationId":"createARole","summary":"Create a role"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_304","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_304"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_305"}},"schemaId":"schema_305"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1account~1role/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_305","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_305"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/account-module/createarole"}],"panels":[]}]},"httpPath":"/api/v2/account/role"},{"label":"Read a role","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/account-module/readarole","routeSlug":"/api-docs/openapi/account-module/readarole","metadata":{"seo":{"title":"Read a role","description":"Returns one role: its name, its code, what it is allowed to do, and any limits onthe records it may act on."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"readARole","name":"Read a role","isWebhook":false,"pointer":"/paths/~1api~1v2~1account~1role~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Read a role","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns one role: its name, its code, what it is allowed to do, and any limits on"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the records it may act on."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"object.permissions"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is narrowed to what the account itself has available, so the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"same role read from two accounts can come back with different keys. The example"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"below shows a handful of them rather than the whole set."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_306","description":"The ID of the role.","required":true}],"pointer":"/paths/~1api~1v2~1account~1role~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1account~1role~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/account/role/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_306"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/v2/account/role/{id}","href":"account-module/readarole","openApiOperationId":"readARole","summary":"Read a role"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_305"}},"schemaId":"schema_305"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1account~1role~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_305","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_305"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/account-module/readarole"}],"panels":[]}]},"httpPath":"/api/v2/account/role/{id}"},{"label":"Update a role","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/account-module/updatearole","routeSlug":"/api-docs/openapi/account-module/updatearole","metadata":{"seo":{"title":"Update a role","description":"Updates a role and returns it in the same shape as reading it. Every field isoptional; a request with an empty body succeeds and changes nothing."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateARole","name":"Update a role","isWebhook":false,"pointer":"/paths/~1api~1v2~1account~1role~1{id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a role","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Updates a role and returns it in the same shape as reading it. Every field is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"optional; a request with an empty body succeeds and changes nothing."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You cannot update a role you hold yourself."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Doing so is refused with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"403"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and a message saying so, which is deliberate rather than an authorisation"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"accident - it stops an administrator editing their own permissions. Have someone"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"on a different role make the change."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"permissions"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" object granting more than the caller's own role holds is rejected"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"422"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"options"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is stored whole."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" The object you send replaces the stored one rather"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"than merging into it, so an update carrying only "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"options.protect_pii"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" clears"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"every other key under it. Send every key you want to keep."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_306","description":"The ID of the role.","required":true}],"pointer":"/paths/~1api~1v2~1account~1role~1{id}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1account~1role~1{id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_307"}},"schemaId":"schema_307","pointer":"/paths/~1api~1v2~1account~1role~1{id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v2/account/role/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_306"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_307"}},"responseCodes":["200","403","404"],"pointer":"/api/v2/account/role/{id}","href":"account-module/updatearole","openApiOperationId":"updateARole","summary":"Update a role"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_307","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_307"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_305"}},"schemaId":"schema_305"},{"code":"403","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_308"}},"schemaId":"schema_308"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1account~1role~1{id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_305","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_305"}}},{"code":"403","schemaId":"schema_308","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_308"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/account-module/updatearole"}],"panels":[]}]},"httpPath":"/api/v2/account/role/{id}"},{"label":"Delete a role","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/account-module/deletearole","routeSlug":"/api-docs/openapi/account-module/deletearole","metadata":{"seo":{"title":"Delete a role","description":"Removes a role. Anyone holding it loses it, and their active API tokens are terminated. A person left with no role at all is no longer an administrator of the account."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteARole","name":"Delete a role","isWebhook":false,"pointer":"/paths/~1api~1v2~1account~1role~1{id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete a role","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Removes a role. Anyone holding it loses it, and their active API tokens are\nterminated. A person left with no role at all is no longer an administrator of\nthe account."},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_306","description":"The ID of the role.","required":true}],"pointer":"/paths/~1api~1v2~1account~1role~1{id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1account~1role~1{id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/v2/account/role/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_306"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["204","404"],"pointer":"/api/v2/account/role/{id}","href":"account-module/deletearole","openApiOperationId":"deleteARole","summary":"Delete a role"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"No content, successful deletion","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1account~1role~1{id}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"204","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/account-module/deletearole"}],"panels":[]}]},"httpPath":"/api/v2/account/role/{id}"},{"label":"List the people holding a role","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/account-module/listthepeopleholdingarole","routeSlug":"/api-docs/openapi/account-module/listthepeopleholdingarole","metadata":{"seo":{"title":"List the people holding a role","description":"Returns everyone in this account who holds the role named in the URL. Each row isthe person's full record, not a membership record, with object.added_at givingthe moment they were assigned the role."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listThePeopleHoldingARole","name":"List the people holding a role","isWebhook":false,"pointer":"/paths/~1api~1v2~1account~1role~1{role_id}~1user/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List the people holding a role","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns everyone in this account who holds the role named in the URL. Each row is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the person's full record, not a membership record, with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"object.added_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" giving"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the moment they were assigned the role."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Only assignments made in the account you are calling as are returned. A role that"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"accounts below this one also use lists its members separately in each of them."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"role_id","in":"path","schemaId":"schema_306","description":"The ID of the role.","required":true}],"pointer":"/paths/~1api~1v2~1account~1role~1{role_id}~1user/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"per_page","in":"query","schemaId":"schema_262","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of results to return per page. The higher the number the longer the request may take."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is highly recommended to use this to avoid timeouts as your data grows."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate results."},"children":[]}]}]}]},{"name":"page","in":"query","schemaId":"schema_263","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The page of results to return. Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"per_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"results. If not specified, defaults to 1."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response's next_page_url will be null if there are no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"more pages."},"children":[]}]}]}]},{"name":"filter","in":"query","schemaId":"schema_264","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A filter to apply to the results. Declared as an array of objects, where each object"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contains an attr (attribute code), operator and value key. Examples:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=name&filter[0][operator]=like&filter[0][value]=luke"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=id&filter[0][operator]=>&filter[0][value]=265"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the filters documentation for more details on how to use this."},"children":[]}]}]}],"example":null},{"name":"sort_by","in":"query","schemaId":"schema_265","description":"The field to sort the results by. No ordering is applied unless you specify one, so\nrow order is not guaranteed. Always send it when paging through a list, otherwise\nrecords can repeat or be missed between pages.\nExample: id","example":null},{"name":"sort_order","in":"query","schemaId":"schema_266","description":"The direction to sort the results by. Can be 'asc' or 'desc', default is 'asc'.","example":null},{"name":"_locale","in":"query","schemaId":"schema_267","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The locale to use for the response. This primarily affects the results of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contain human-readable labels and terms, as well as locale-specific date formats.,"},"children":[]}]}]}]}],"pointer":"/paths/~1api~1v2~1account~1role~1{role_id}~1user/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1account~1role~1{role_id}~1user/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/account/role/{role_id}/user","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"role_id","in":"path","required":true,"schemaId":"schema_306"}],"query":[{"name":"per_page","in":"query","required":false,"schemaId":"schema_262"},{"name":"page","in":"query","required":false,"schemaId":"schema_263"},{"name":"filter","in":"query","required":false,"schemaId":"schema_264"},{"name":"sort_by","in":"query","required":false,"schemaId":"schema_265"},{"name":"sort_order","in":"query","required":false,"schemaId":"schema_266"},{"name":"_locale","in":"query","required":false,"schemaId":"schema_267"}],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/account/role/{role_id}/user","href":"account-module/listthepeopleholdingarole","openApiOperationId":"listThePeopleHoldingARole","summary":"List the people holding a role"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_309"}},"schemaId":"schema_309"}],"pointer":"/paths/~1api~1v2~1account~1role~1{role_id}~1user/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_309","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_309"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/account-module/listthepeopleholdingarole"}],"panels":[]}]},"httpPath":"/api/v2/account/role/{role_id}/user"},{"label":"Give a person a role","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/account-module/giveapersonarole","routeSlug":"/api-docs/openapi/account-module/giveapersonarole","metadata":{"seo":{"title":"Give a person a role","description":"Assigns one person the role named in the URL. A 201 carries no body - read therole's members afterwards if you need the resulting record."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"giveAPersonARole","name":"Give a person a role","isWebhook":false,"pointer":"/paths/~1api~1v2~1account~1role~1{role_id}~1user/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Give a person a role","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Assigns one person the role named in the URL. "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A 201 carries no body"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - read the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"role's members afterwards if you need the resulting record."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A person may hold only one role per account. Naming someone who already holds one"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"is refused with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and a message saying so, and the way to move them is to"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"remove the existing assignment first. A "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is also what you get when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user_id"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"is missing altogether."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The person has to belong to the same account as the role, and an administrator"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"cannot assign a role to themselves."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"role_id","in":"path","schemaId":"schema_306","description":"The ID of the role.","required":true}],"pointer":"/paths/~1api~1v2~1account~1role~1{role_id}~1user/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1account~1role~1{role_id}~1user/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_310"}},"schemaId":"schema_310","pointer":"/paths/~1api~1v2~1account~1role~1{role_id}~1user/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/account/role/{role_id}/user","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"role_id","in":"path","required":true,"schemaId":"schema_306"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_310"}},"responseCodes":["201","400","404"],"pointer":"/api/v2/account/role/{role_id}/user","href":"account-module/giveapersonarole","openApiOperationId":"giveAPersonARole","summary":"Give a person a role"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_310","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_310"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_311"}},"schemaId":"schema_311"},{"code":"400","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_312"}},"schemaId":"schema_312"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1account~1role~1{role_id}~1user/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_311","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_311"}}},{"code":"400","schemaId":"schema_312","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_312"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/account-module/giveapersonarole"}],"panels":[]}]},"httpPath":"/api/v2/account/role/{role_id}/user"},{"label":"Give a role to many people","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/account-module/givearoletomanypeople","routeSlug":"/api-docs/openapi/account-module/givearoletomanypeople","metadata":{"seo":{"title":"Give a role to many people","description":"Queues the work of assigning a set of people the role named in the URL and returnsa token for the queued job. Nothing is assigned by the time the response comesback, and the token is not something you can poll - confirm the outcome bylisting the role's members."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"giveARoleToManyPeople","name":"Give a role to many people","isWebhook":false,"pointer":"/paths/~1api~1v2~1account~1role~1{role_id}~1user~1mass-create/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Give a role to many people","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Queues the work of assigning a set of people the role named in the URL and returns"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"a token for the queued job. "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Nothing is assigned by the time the response comes"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"back"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and the token is not something you can poll - confirm the outcome by"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"listing the role's members."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send the fields as form fields or in the query string, not as a JSON body."},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is read from the query and form data only, so a request carrying it as"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"JSON comes back as a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with nothing assigned."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A request whose fields are the right shape always returns a queue token, whether"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"or not the background work then succeeds: someone who belongs to another account,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"already holds a role here, or would exceed the account's administrator limit is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"skipped rather than reported."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"role_id","in":"path","schemaId":"schema_306","description":"The ID of the role.","required":true}],"pointer":"/paths/~1api~1v2~1account~1role~1{role_id}~1user~1mass-create/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1account~1role~1{role_id}~1user~1mass-create/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_313"}},"schemaId":"schema_313","pointer":"/paths/~1api~1v2~1account~1role~1{role_id}~1user~1mass-create/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/account/role/{role_id}/user/mass-create","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"role_id","in":"path","required":true,"schemaId":"schema_306"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_313"}},"responseCodes":["200"],"pointer":"/api/v2/account/role/{role_id}/user/mass-create","href":"account-module/givearoletomanypeople","openApiOperationId":"giveARoleToManyPeople","summary":"Give a role to many people"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_313","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_313"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_284"}},"schemaId":"schema_284"}],"pointer":"/paths/~1api~1v2~1account~1role~1{role_id}~1user~1mass-create/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_284","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_284"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/account-module/givearoletomanypeople"}],"panels":[]}]},"httpPath":"/api/v2/account/role/{role_id}/user/mass-create"}],"content":{"contentType":"group","meta":{"name":"Account Module"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Account Module","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v2/account","summary":"List sub-accounts","prefix":{"name":"get","color":"get"},"badges":[],"link":"/account-module/listsubaccounts","deprecated":false},{"title":"/api/v2/account","summary":"Create a sub-account","prefix":{"name":"post","color":"post"},"badges":[],"link":"/account-module/createasubaccount","deprecated":false},{"title":"/api/v2/account/{id}","summary":"Read a sub-account","prefix":{"name":"get","color":"get"},"badges":[],"link":"/account-module/readasubaccount","deprecated":false},{"title":"/api/v2/account/{id}","summary":"Update a sub-account","prefix":{"name":"put","color":"put"},"badges":[],"link":"/account-module/updateasubaccount","deprecated":false},{"title":"/api/v2/account/{id}","summary":"Delete a sub-account","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/account-module/deleteasubaccount","deprecated":false},{"title":"/api/v2/account/role","summary":"List roles","prefix":{"name":"get","color":"get"},"badges":[],"link":"/account-module/listroles","deprecated":false},{"title":"/api/v2/account/role","summary":"Create a role","prefix":{"name":"post","color":"post"},"badges":[],"link":"/account-module/createarole","deprecated":false},{"title":"/api/v2/account/role/{id}","summary":"Read a role","prefix":{"name":"get","color":"get"},"badges":[],"link":"/account-module/readarole","deprecated":false},{"title":"/api/v2/account/role/{id}","summary":"Update a role","prefix":{"name":"put","color":"put"},"badges":[],"link":"/account-module/updatearole","deprecated":false},{"title":"/api/v2/account/role/{id}","summary":"Delete a role","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/account-module/deletearole","deprecated":false},{"title":"/api/v2/account/role/{role_id}/user","summary":"List the people holding a role","prefix":{"name":"get","color":"get"},"badges":[],"link":"/account-module/listthepeopleholdingarole","deprecated":false},{"title":"/api/v2/account/role/{role_id}/user","summary":"Give a person a role","prefix":{"name":"post","color":"post"},"badges":[],"link":"/account-module/giveapersonarole","deprecated":false},{"title":"/api/v2/account/role/{role_id}/user/mass-create","summary":"Give a role to many people","prefix":{"name":"post","color":"post"},"badges":[],"link":"/account-module/givearoletomanypeople","deprecated":false}]}]}]}]}},{"type":"group","label":"Blog Module","link":"/api-docs/openapi/blog-module","routeSlug":"/api-docs/openapi/blog-module","items":[{"label":"List articles","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/blog-module/listarticles","routeSlug":"/api-docs/openapi/blog-module/listarticles","metadata":{"seo":{"title":"List articles","description":"Returns a paginated list of the articles the caller is allowed to read, in the current account and the accounts above it. A caller with the blog:article:read permission sees every article; anyone else sees only published ones, and an unauthenticated caller sees only articles that are both published and marked public."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listArticles","name":"List articles","isWebhook":false,"pointer":"/paths/~1api~1v2~1blog~1article/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List articles","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns a paginated list of the articles the caller is allowed to read, in\nthe current account and the accounts above it. A caller with the\nblog:article:read permission sees every article; anyone else sees only\npublished ones, and an unauthenticated caller sees only articles that are\nboth published and marked public."},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"per_page","in":"query","schemaId":"schema_262","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of results to return per page. The higher the number the longer the request may take."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is highly recommended to use this to avoid timeouts as your data grows."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate results."},"children":[]}]}]}]},{"name":"page","in":"query","schemaId":"schema_263","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The page of results to return. Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"per_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"results. If not specified, defaults to 1."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response's next_page_url will be null if there are no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"more pages."},"children":[]}]}]}]},{"name":"filter","in":"query","schemaId":"schema_264","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A filter to apply to the results. Declared as an array of objects, where each object"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contains an attr (attribute code), operator and value key. Examples:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=name&filter[0][operator]=like&filter[0][value]=luke"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=id&filter[0][operator]=>&filter[0][value]=265"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the filters documentation for more details on how to use this."},"children":[]}]}]}],"example":null},{"name":"sort_by","in":"query","schemaId":"schema_265","description":"The field to sort the results by. No ordering is applied unless you specify one, so\nrow order is not guaranteed. Always send it when paging through a list, otherwise\nrecords can repeat or be missed between pages.\nExample: id","example":null},{"name":"sort_order","in":"query","schemaId":"schema_266","description":"The direction to sort the results by. Can be 'asc' or 'desc', default is 'asc'.","example":null},{"name":"_locale","in":"query","schemaId":"schema_267","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The locale to use for the response. This primarily affects the results of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contain human-readable labels and terms, as well as locale-specific date formats.,"},"children":[]}]}]}]}],"pointer":"/paths/~1api~1v2~1blog~1article/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1blog~1article/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/blog/article","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[{"name":"per_page","in":"query","required":false,"schemaId":"schema_262"},{"name":"page","in":"query","required":false,"schemaId":"schema_263"},{"name":"filter","in":"query","required":false,"schemaId":"schema_264"},{"name":"sort_by","in":"query","required":false,"schemaId":"schema_265"},{"name":"sort_order","in":"query","required":false,"schemaId":"schema_266"},{"name":"_locale","in":"query","required":false,"schemaId":"schema_267"}],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/blog/article","href":"blog-module/listarticles","openApiOperationId":"listArticles","summary":"List articles"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_314"}},"schemaId":"schema_314"}],"pointer":"/paths/~1api~1v2~1blog~1article/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_314","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_314"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/blog-module/listarticles"}],"panels":[]}]},"httpPath":"/api/v2/blog/article"},{"label":"Create an article","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/blog-module/createanarticle","routeSlug":"/api-docs/openapi/blog-module/createanarticle","metadata":{"seo":{"title":"Create an article","description":"Creates an article in the current account, with the calling user recorded as its author. The response is the same shape as reading the article, so a follow-up read is not needed."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createAnArticle","name":"Create an article","isWebhook":false,"pointer":"/paths/~1api~1v2~1blog~1article/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create an article","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Creates an article in the current account, with the calling user recorded\nas its author. The response is the same shape as reading the article, so a\nfollow-up read is not needed.\n\nA public token is generated on create and returned as object.token. It is\nthe token the publicly accessible URL uses, and it cannot be set by the\ncaller."},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1blog~1article/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_315"}},"schemaId":"schema_315","pointer":"/paths/~1api~1v2~1blog~1article/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/blog/article","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_315"}},"responseCodes":["201","404"],"pointer":"/api/v2/blog/article","href":"blog-module/createanarticle","openApiOperationId":"createAnArticle","summary":"Create an article"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_315","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_315"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_316"}},"schemaId":"schema_316"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1blog~1article/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_316","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_316"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/blog-module/createanarticle"}],"panels":[]}]},"httpPath":"/api/v2/blog/article"},{"label":"Read an article","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/blog-module/readanarticle","routeSlug":"/api-docs/openapi/blog-module/readanarticle","metadata":{"seo":{"title":"Read an article","description":"Returns a single article. Reading also records the article as read for thecalling user the first time they fetch it, which is what populatesnice.read_at and makes nice.liked meaningful on later reads."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"readAnArticle","name":"Read an article","isWebhook":false,"pointer":"/paths/~1api~1v2~1blog~1article~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Read an article","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns a single article. Reading also records the article as read for the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"calling user the first time they fetch it, which is what populates"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"nice.read_at and makes nice.liked meaningful on later reads."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the article.","required":true}],"pointer":"/paths/~1api~1v2~1blog~1article~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1blog~1article~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/blog/article/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/v2/blog/article/{id}","href":"blog-module/readanarticle","openApiOperationId":"readAnArticle","summary":"Read an article"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_316"}},"schemaId":"schema_316"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1blog~1article~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_316","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_316"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/blog-module/readanarticle"}],"panels":[]}]},"httpPath":"/api/v2/blog/article/{id}"},{"label":"Update an article","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/blog-module/updateanarticle","routeSlug":"/api-docs/openapi/blog-module/updateanarticle","metadata":{"seo":{"title":"Update an article","description":"Updates the fields supplied and leaves the rest untouched, then returns the article in the same shape as reading it. Every field is optional. Invalid input returns a 422 identifying the fields at fault."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateAnArticle","name":"Update an article","isWebhook":false,"pointer":"/paths/~1api~1v2~1blog~1article~1{id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update an article","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Updates the fields supplied and leaves the rest untouched, then returns the\narticle in the same shape as reading it. Every field is optional. Invalid\ninput returns a 422 identifying the fields at fault.\n\nSending a translatable field as a plain string replaces only the value for\nthe request locale. Send an object keyed by locale to set several at once."},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the article.","required":true}],"pointer":"/paths/~1api~1v2~1blog~1article~1{id}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1blog~1article~1{id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_318"}},"schemaId":"schema_318","pointer":"/paths/~1api~1v2~1blog~1article~1{id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v2/blog/article/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_318"}},"responseCodes":["200","404"],"pointer":"/api/v2/blog/article/{id}","href":"blog-module/updateanarticle","openApiOperationId":"updateAnArticle","summary":"Update an article"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_318","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_318"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_316"}},"schemaId":"schema_316"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1blog~1article~1{id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_316","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_316"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/blog-module/updateanarticle"}],"panels":[]}]},"httpPath":"/api/v2/blog/article/{id}"},{"label":"Delete an article","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/blog-module/deleteanarticle","routeSlug":"/api-docs/openapi/blog-module/deleteanarticle","metadata":{"seo":{"title":"Delete an article","description":"Permanently deletes the article. Its publicly accessible URL stops resolving immediately."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteAnArticle","name":"Delete an article","isWebhook":false,"pointer":"/paths/~1api~1v2~1blog~1article~1{id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete an article","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Permanently deletes the article. Its publicly accessible URL stops resolving\nimmediately."},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the article.","required":true}],"pointer":"/paths/~1api~1v2~1blog~1article~1{id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1blog~1article~1{id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/v2/blog/article/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["204","404"],"pointer":"/api/v2/blog/article/{id}","href":"blog-module/deleteanarticle","openApiOperationId":"deleteAnArticle","summary":"Delete an article"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"No content, successful deletion","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1blog~1article~1{id}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"204","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/blog-module/deleteanarticle"}],"panels":[]}]},"httpPath":"/api/v2/blog/article/{id}"}],"content":{"contentType":"group","meta":{"name":"Blog Module"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Blog Module","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v2/blog/article","summary":"List articles","prefix":{"name":"get","color":"get"},"badges":[],"link":"/blog-module/listarticles","deprecated":false},{"title":"/api/v2/blog/article","summary":"Create an article","prefix":{"name":"post","color":"post"},"badges":[],"link":"/blog-module/createanarticle","deprecated":false},{"title":"/api/v2/blog/article/{id}","summary":"Read an article","prefix":{"name":"get","color":"get"},"badges":[],"link":"/blog-module/readanarticle","deprecated":false},{"title":"/api/v2/blog/article/{id}","summary":"Update an article","prefix":{"name":"put","color":"put"},"badges":[],"link":"/blog-module/updateanarticle","deprecated":false},{"title":"/api/v2/blog/article/{id}","summary":"Delete an article","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/blog-module/deleteanarticle","deprecated":false}]}]}]}]}},{"type":"group","label":"Training Module","link":"/api-docs/openapi/training-module","routeSlug":"/api-docs/openapi/training-module","items":[{"label":"List training modules","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/training-module/listtrainingmodules","routeSlug":"/api-docs/openapi/training-module/listtrainingmodules","metadata":{"seo":{"title":"List training modules","description":"Returns a paginated list of the training modules the current account canuse. That is the account's own modules, plus modules owned by an accountabove it in the hierarchy that are marked is_inheritable. On each item,nice.is_foreign_account says whether the module belongs to another accountand nice.acts_as_native whether an inherited one behaves as if it were thecurrent account's own."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listTrainingModules","name":"List training modules","isWebhook":false,"pointer":"/paths/~1api~1v2~1training/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List training modules","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns a paginated list of the training modules the current account can"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"use. That is the account's own modules, plus modules owned by an account"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"above it in the hierarchy that are marked is_inheritable. On each item,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"nice.is_foreign_account says whether the module belongs to another account"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and nice.acts_as_native whether an inherited one behaves as if it were the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"current account's own."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"per_page","in":"query","schemaId":"schema_262","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of results to return per page. The higher the number the longer the request may take."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is highly recommended to use this to avoid timeouts as your data grows."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate results."},"children":[]}]}]}]},{"name":"page","in":"query","schemaId":"schema_263","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The page of results to return. Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"per_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"results. If not specified, defaults to 1."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response's next_page_url will be null if there are no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"more pages."},"children":[]}]}]}]},{"name":"filter","in":"query","schemaId":"schema_264","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A filter to apply to the results. Declared as an array of objects, where each object"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contains an attr (attribute code), operator and value key. Examples:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=name&filter[0][operator]=like&filter[0][value]=luke"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=id&filter[0][operator]=>&filter[0][value]=265"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the filters documentation for more details on how to use this."},"children":[]}]}]}],"example":null},{"name":"sort_by","in":"query","schemaId":"schema_265","description":"The field to sort the results by. No ordering is applied unless you specify one, so\nrow order is not guaranteed. Always send it when paging through a list, otherwise\nrecords can repeat or be missed between pages.\nExample: id","example":null},{"name":"sort_order","in":"query","schemaId":"schema_266","description":"The direction to sort the results by. Can be 'asc' or 'desc', default is 'asc'.","example":null},{"name":"_locale","in":"query","schemaId":"schema_267","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The locale to use for the response. This primarily affects the results of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contain human-readable labels and terms, as well as locale-specific date formats.,"},"children":[]}]}]}]},{"name":"extras","in":"query","schemaId":"schema_268","description":"A list of extras to include in the response. These are objects or arrays that are not part of\nthe model's primary attributes, such as stats and counts.\nFor fast responses, avoid requesting them if you don't need them. "}],"pointer":"/paths/~1api~1v2~1training/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1training/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/training","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[{"name":"per_page","in":"query","required":false,"schemaId":"schema_262"},{"name":"page","in":"query","required":false,"schemaId":"schema_263"},{"name":"filter","in":"query","required":false,"schemaId":"schema_264"},{"name":"sort_by","in":"query","required":false,"schemaId":"schema_265"},{"name":"sort_order","in":"query","required":false,"schemaId":"schema_266"},{"name":"_locale","in":"query","required":false,"schemaId":"schema_267"},{"name":"extras","in":"query","required":false,"schemaId":"schema_268"}],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/training","href":"training-module/listtrainingmodules","openApiOperationId":"listTrainingModules","summary":"List training modules"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_319"}},"schemaId":"schema_319"}],"pointer":"/paths/~1api~1v2~1training/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_319","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_319"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/training-module/listtrainingmodules"}],"panels":[]}]},"httpPath":"/api/v2/training"},{"label":"Create a training module","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/training-module/createatrainingmodule","routeSlug":"/api-docs/openapi/training-module/createatrainingmodule","metadata":{"seo":{"title":"Create a training module","description":"Creates a training module in the current account. account_id is always thecalling account and cannot be set from the request, and the module's tokenis generated on create. The response is the same shape as reading themodule, so a follow-up read is not needed."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createATrainingModule","name":"Create a training module","isWebhook":false,"pointer":"/paths/~1api~1v2~1training/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a training module","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Creates a training module in the current account. account_id is always the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"calling account and cannot be set from the request, and the module's token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"is generated on create. The response is the same shape as reading the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"module, so a follow-up read is not needed."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A created module has no steps. Add them through the training step endpoints."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Invalid input returns a 422 identifying the fields at fault. The field notes"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"below say which rules apply to each."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1training/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_320"}},"schemaId":"schema_320","pointer":"/paths/~1api~1v2~1training/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/training","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_320"}},"responseCodes":["201","404"],"pointer":"/api/v2/training","href":"training-module/createatrainingmodule","openApiOperationId":"createATrainingModule","summary":"Create a training module"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_320","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_320"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_321"}},"schemaId":"schema_321"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1training/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_321","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_321"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/training-module/createatrainingmodule"}],"panels":[]}]},"httpPath":"/api/v2/training"},{"label":"Read a training module","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/training-module/readatrainingmodule","routeSlug":"/api-docs/openapi/training-module/readatrainingmodule","metadata":{"seo":{"title":"Read a training module","description":"Returns a single training module."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"readATrainingModule","name":"Read a training module","isWebhook":false,"pointer":"/paths/~1api~1v2~1training~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Read a training module","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns a single training module."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This is the one training endpoint that does not require authentication, so"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"that a module set up for anonymous submissions can be read from a public"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"link. What an unauthenticated caller gets back depends on the module: the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"full body if it has a form_id, because a module with a form attached counts"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"as public, and an empty object otherwise. An authenticated caller who may"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"not read the module also gets an empty object."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The permissions block is only present for an authenticated caller."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the training module.","required":true}],"pointer":"/paths/~1api~1v2~1training~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1training~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/training/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/v2/training/{id}","href":"training-module/readatrainingmodule","openApiOperationId":"readATrainingModule","summary":"Read a training module"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_321"}},"schemaId":"schema_321"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1training~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_321","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_321"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/training-module/readatrainingmodule"}],"panels":[]}]},"httpPath":"/api/v2/training/{id}"},{"label":"Update a training module","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/training-module/updateatrainingmodule","routeSlug":"/api-docs/openapi/training-module/updateatrainingmodule","metadata":{"seo":{"title":"Update a training module","description":"Updates the fields supplied and leaves the rest untouched, then returns themodule in the same shape as reading it. Every field is optional."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateATrainingModule","name":"Update a training module","isWebhook":false,"pointer":"/paths/~1api~1v2~1training~1{id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a training module","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Updates the fields supplied and leaves the rest untouched, then returns the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"module in the same shape as reading it. Every field is optional."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"meta is merged rather than replaced: subkeys already stored keep their values"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"unless the request sends them. This is the one field where update behaves"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"differently to create, which stores the object as sent."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"service is ignored for an external module - one whose service is not one of"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the four values Rosterfy hosts. The request succeeds and the rest of the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"update is applied; only that field is dropped. Sending scorm_upload here"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"hands the zip to the unzip process, which runs in the background, so a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"successful response does not mean the package has been unpacked yet."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the training module.","required":true}],"pointer":"/paths/~1api~1v2~1training~1{id}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1training~1{id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_322"}},"schemaId":"schema_322","pointer":"/paths/~1api~1v2~1training~1{id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v2/training/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_322"}},"responseCodes":["200","404"],"pointer":"/api/v2/training/{id}","href":"training-module/updateatrainingmodule","openApiOperationId":"updateATrainingModule","summary":"Update a training module"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_322","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_322"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_321"}},"schemaId":"schema_321"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1training~1{id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_321","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_321"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/training-module/updateatrainingmodule"}],"panels":[]}]},"httpPath":"/api/v2/training/{id}"},{"label":"Delete a training module","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/training-module/deleteatrainingmodule","routeSlug":"/api-docs/openapi/training-module/deleteatrainingmodule","metadata":{"seo":{"title":"Delete a training module","description":"Deletes the module and, with it, every user's assignment to and progress on it."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteATrainingModule","name":"Delete a training module","isWebhook":false,"pointer":"/paths/~1api~1v2~1training~1{id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete a training module","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Deletes the module and, with it, every user's assignment to and progress on it."},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the training module.","required":true}],"pointer":"/paths/~1api~1v2~1training~1{id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1training~1{id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/v2/training/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["204","404"],"pointer":"/api/v2/training/{id}","href":"training-module/deleteatrainingmodule","openApiOperationId":"deleteATrainingModule","summary":"Delete a training module"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"No content, successful deletion","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1training~1{id}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"204","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/training-module/deleteatrainingmodule"}],"panels":[]}]},"httpPath":"/api/v2/training/{id}"},{"label":"List a module's assigned users","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/training-module/listamodulesassignedusers","routeSlug":"/api-docs/openapi/training-module/listamodulesassignedusers","metadata":{"seo":{"title":"List a module's assigned users","description":"Returns the users assigned to a training module, one row per assignment,with the status and progress of each."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listAModulesAssignedUsers","name":"List a module's assigned users","isWebhook":false,"pointer":"/paths/~1api~1v2~1training~1{training_id}~1user/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List a module's assigned users","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the users assigned to a training module, one row per assignment,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"with the status and progress of each."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An assignment whose user has since been deleted is left out, so this list can"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"be shorter than the number of assignments the module has ever had."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response is only wrapped in a paginated envelope when a page parameter is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"sent. Without one, every match comes back as a flat array."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Related records are not included unless asked for. Requesting the user"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"relation returns that user's full profile, so ask for it only when the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"profile is what you need - the assignment itself already carries user_id."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"training_id","in":"path","schemaId":"schema_317","description":"The ID of the training module.","required":true}],"pointer":"/paths/~1api~1v2~1training~1{training_id}~1user/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"per_page","in":"query","schemaId":"schema_262","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of results to return per page. The higher the number the longer the request may take."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is highly recommended to use this to avoid timeouts as your data grows."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate results."},"children":[]}]}]}]},{"name":"page","in":"query","schemaId":"schema_263","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The page of results to return. Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"per_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"results. If not specified, defaults to 1."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response's next_page_url will be null if there are no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"more pages."},"children":[]}]}]}]},{"name":"filter","in":"query","schemaId":"schema_264","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A filter to apply to the results. Declared as an array of objects, where each object"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contains an attr (attribute code), operator and value key. Examples:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=name&filter[0][operator]=like&filter[0][value]=luke"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=id&filter[0][operator]=>&filter[0][value]=265"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the filters documentation for more details on how to use this."},"children":[]}]}]}],"example":null},{"name":"sort_by","in":"query","schemaId":"schema_265","description":"The field to sort the results by. No ordering is applied unless you specify one, so\nrow order is not guaranteed. Always send it when paging through a list, otherwise\nrecords can repeat or be missed between pages.\nExample: id","example":null},{"name":"sort_order","in":"query","schemaId":"schema_266","description":"The direction to sort the results by. Can be 'asc' or 'desc', default is 'asc'.","example":null},{"name":"_locale","in":"query","schemaId":"schema_267","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The locale to use for the response. This primarily affects the results of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contain human-readable labels and terms, as well as locale-specific date formats.,"},"children":[]}]}]}]},{"name":"extras","in":"query","schemaId":"schema_323","description":"A list of extras to include in the response. These are objects or arrays that are not part of\nthe model's primary attributes, such as stats and counts.\nFor fast responses, avoid requesting them if you don't need them. "},{"name":"with","in":"query","schemaId":"schema_324","description":"A list of relations to include in the response. May be single records or collections.\nIt is often more efficient to retrieve this way, to avoid follow-up API calls."}],"pointer":"/paths/~1api~1v2~1training~1{training_id}~1user/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1training~1{training_id}~1user/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/training/{training_id}/user","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"training_id","in":"path","required":true,"schemaId":"schema_317"}],"query":[{"name":"per_page","in":"query","required":false,"schemaId":"schema_262"},{"name":"page","in":"query","required":false,"schemaId":"schema_263"},{"name":"filter","in":"query","required":false,"schemaId":"schema_264"},{"name":"sort_by","in":"query","required":false,"schemaId":"schema_265"},{"name":"sort_order","in":"query","required":false,"schemaId":"schema_266"},{"name":"_locale","in":"query","required":false,"schemaId":"schema_267"},{"name":"extras","in":"query","required":false,"schemaId":"schema_323"},{"name":"with","in":"query","required":false,"schemaId":"schema_324"}],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/training/{training_id}/user","href":"training-module/listamodulesassignedusers","openApiOperationId":"listAModulesAssignedUsers","summary":"List a module's assigned users"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_325"}},"schemaId":"schema_325"}],"pointer":"/paths/~1api~1v2~1training~1{training_id}~1user/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_325","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_325"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/training-module/listamodulesassignedusers"}],"panels":[]}]},"httpPath":"/api/v2/training/{training_id}/user"},{"label":"Assign a module to a user","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/training-module/assignamoduletoauser","routeSlug":"/api-docs/openapi/training-module/assignamoduletoauser","metadata":{"seo":{"title":"Assign a module to a user","description":"Assigns the training module in the URL to one user and returns the newassignment in the same shape as reading it, so a follow-up read is notneeded."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"assignAModuleToAUser","name":"Assign a module to a user","isWebhook":false,"pointer":"/paths/~1api~1v2~1training~1{training_id}~1user/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Assign a module to a user","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Assigns the training module in the URL to one user and returns the new"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"assignment in the same shape as reading it, so a follow-up read is not"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"needed."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A user can hold only one live assignment per module. Asking for one that"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"already exists returns a "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"403"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", not a conflict or a duplicate - so check"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"for an existing assignment first if you cannot be sure. Deleting an"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"assignment frees the user to be assigned again."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An unknown user, or a request with no user_id at all, returns a "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"404"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Only user_id and status are read. Every other writable field is ignored here,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"so a new assignment always starts with no score, no external reference and no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"steps completed; set those with a follow-up update. status is checked against"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the five permitted values and a 422 names it if it is not one of them."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"training_id","in":"path","schemaId":"schema_317","description":"The ID of the training module.","required":true}],"pointer":"/paths/~1api~1v2~1training~1{training_id}~1user/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1training~1{training_id}~1user/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_326"}},"schemaId":"schema_326","pointer":"/paths/~1api~1v2~1training~1{training_id}~1user/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/training/{training_id}/user","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"training_id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_326"}},"responseCodes":["201","403","404"],"pointer":"/api/v2/training/{training_id}/user","href":"training-module/assignamoduletoauser","openApiOperationId":"assignAModuleToAUser","summary":"Assign a module to a user"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_326","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_326"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_327"}},"schemaId":"schema_327"},{"code":"403","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_328"}},"schemaId":"schema_328"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1training~1{training_id}~1user/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_327","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_327"}}},{"code":"403","schemaId":"schema_328","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_328"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/training-module/assignamoduletoauser"}],"panels":[]}]},"httpPath":"/api/v2/training/{training_id}/user"},{"label":"Assign a module to many users","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/training-module/assignamoduletomanyusers","routeSlug":"/api-docs/openapi/training-module/assignamoduletomanyusers","metadata":{"seo":{"title":"Assign a module to many users","description":"Assigns the training module in the URL to a set of users at once."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"assignAModuleToManyUsers","name":"Assign a module to many users","isWebhook":false,"pointer":"/paths/~1api~1v2~1training~1{training_id}~1user/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Assign a module to many users","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Assigns the training module in the URL to a set of users at once."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This write is queued."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" The response does not contain the assignments and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"does not mean they exist yet - it means the request was accepted and the work"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"is running in the background. The payload is a single queue field holding an"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"identifier for that work. There is no endpoint that resolves the identifier,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"so confirm the outcome by listing the module's assigned users."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Choose the users either way round:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"applyTo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" holding the user IDs to add."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send any other "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"applyTo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" value to add every user the caller can see, narrowed"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"by an optional "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filter"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", in the same form the user listing accepts."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Users already assigned to the module are skipped, so the same request can be"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"repeated safely. A request naming no users still succeeds and assigns nobody."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Invalid input returns a 422 before anything is queued."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"training_id","in":"path","schemaId":"schema_317","description":"The ID of the training module.","required":true}],"pointer":"/paths/~1api~1v2~1training~1{training_id}~1user/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1training~1{training_id}~1user/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_329"}},"schemaId":"schema_329","pointer":"/paths/~1api~1v2~1training~1{training_id}~1user/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v2/training/{training_id}/user","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"training_id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_329"}},"responseCodes":["200"],"pointer":"/api/v2/training/{training_id}/user","href":"training-module/assignamoduletomanyusers","openApiOperationId":"assignAModuleToManyUsers","summary":"Assign a module to many users"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_329","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_329"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_284"}},"schemaId":"schema_284"}],"pointer":"/paths/~1api~1v2~1training~1{training_id}~1user/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_284","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_284"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/training-module/assignamoduletomanyusers"}],"panels":[]}]},"httpPath":"/api/v2/training/{training_id}/user"},{"label":"Read an assignment","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/training-module/readanassignment","routeSlug":"/api-docs/openapi/training-module/readanassignment","metadata":{"seo":{"title":"Read an assignment","description":"Returns one user's assignment to a training module: the status they are at,how many steps they have finished, their score, and when the completionexpires."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"readAnAssignment","name":"Read an assignment","isWebhook":false,"pointer":"/paths/~1api~1v2~1training~1{training_id}~1user~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Read an assignment","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns one user's assignment to a training module: the status they are at,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"how many steps they have finished, their score, and when the completion"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"expires."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"nice carries the readable form of the same record - the module's name, the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"status as a label, and steps_percentage and score_percentage worked out"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"against the module's totals. steps_percentage is the more useful progress"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"figure, since steps_completed on its own means nothing without the module's"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"step count."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The assignment must belong to the module in the URL; a mismatched pair"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"returns a 404."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"training_id","in":"path","schemaId":"schema_317","description":"The ID of the training module.","required":true},{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the assignment.","required":true}],"pointer":"/paths/~1api~1v2~1training~1{training_id}~1user~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1training~1{training_id}~1user~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/training/{training_id}/user/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"training_id","in":"path","required":true,"schemaId":"schema_317"},{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/v2/training/{training_id}/user/{id}","href":"training-module/readanassignment","openApiOperationId":"readAnAssignment","summary":"Read an assignment"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_327"}},"schemaId":"schema_327"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1training~1{training_id}~1user~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_327","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_327"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/training-module/readanassignment"}],"panels":[]}]},"httpPath":"/api/v2/training/{training_id}/user/{id}"},{"label":"Update an assignment","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/training-module/updateanassignment","routeSlug":"/api-docs/openapi/training-module/updateanassignment","metadata":{"seo":{"title":"Update an assignment","description":"Updates the fields supplied and leaves the rest untouched, then returns theassignment in the same shape as reading it. Every field is optional and anempty body is a valid request that changes nothing."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateAnAssignment","name":"Update an assignment","isWebhook":false,"pointer":"/paths/~1api~1v2~1training~1{training_id}~1user~1{id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update an assignment","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Updates the fields supplied and leaves the rest untouched, then returns the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"assignment in the same shape as reading it. Every field is optional and an"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"empty body is a valid request that changes nothing."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"status and steps_completed are kept consistent with each other"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", so"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"sending one can change the other:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Setting status to COMPLETE sets steps_completed to the module's full step"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"count."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Setting status to INCOMPLETE on an assignment that was COMPLETE resets"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"steps_completed to 0."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sending a steps_completed equal to the module's full step count sets status"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"to COMPLETE, whether or not status was sent."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"So a request that sends only one of the two can come back with both changed."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Read the returned record rather than assuming the values you sent."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Moving an assignment to a status that counts as finished - COMPLETE, PASSED or"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"EXEMPT - is what marks the module done for that user, and runs whatever the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"module has set up to follow completion, such as issuing a certificate. If the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"module has a retake period, expires_at is set from it at the same time."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The assignment must belong to the module in the URL; a mismatched pair returns"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"a 404. Invalid input returns a 422 identifying the fields at fault."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send neither training_id nor user_id unless you mean to hand the assignment to"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"a different module or a different user. Changing training_id is applied and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"then"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returns a 404, because the updated record no longer belongs to the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"module in the URL - so a 404 here does not mean the change was rejected."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"training_id","in":"path","schemaId":"schema_317","description":"The ID of the training module.","required":true},{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the assignment.","required":true}],"pointer":"/paths/~1api~1v2~1training~1{training_id}~1user~1{id}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1training~1{training_id}~1user~1{id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_330"}},"schemaId":"schema_330","pointer":"/paths/~1api~1v2~1training~1{training_id}~1user~1{id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v2/training/{training_id}/user/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"training_id","in":"path","required":true,"schemaId":"schema_317"},{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_330"}},"responseCodes":["200","404"],"pointer":"/api/v2/training/{training_id}/user/{id}","href":"training-module/updateanassignment","openApiOperationId":"updateAnAssignment","summary":"Update an assignment"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_330","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_330"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_327"}},"schemaId":"schema_327"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1training~1{training_id}~1user~1{id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_327","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_327"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/training-module/updateanassignment"}],"panels":[]}]},"httpPath":"/api/v2/training/{training_id}/user/{id}"},{"label":"Delete an assignment","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/training-module/deleteanassignment","routeSlug":"/api-docs/openapi/training-module/deleteanassignment","metadata":{"seo":{"title":"Delete an assignment","description":"Removes a user's assignment to the module, along with the progress recorded against it. There is no endpoint that restores one, so treat this as final."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteAnAssignment","name":"Delete an assignment","isWebhook":false,"pointer":"/paths/~1api~1v2~1training~1{training_id}~1user~1{id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete an assignment","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Removes a user's assignment to the module, along with the progress recorded\nagainst it. There is no endpoint that restores one, so treat this as final.\n\nDeleting an assignment frees the user to be assigned the module again, which\nstarts their progress from nothing."},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"training_id","in":"path","schemaId":"schema_317","description":"The ID of the training module.","required":true},{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the assignment.","required":true}],"pointer":"/paths/~1api~1v2~1training~1{training_id}~1user~1{id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1training~1{training_id}~1user~1{id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/v2/training/{training_id}/user/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"training_id","in":"path","required":true,"schemaId":"schema_317"},{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["204","404"],"pointer":"/api/v2/training/{training_id}/user/{id}","href":"training-module/deleteanassignment","openApiOperationId":"deleteAnAssignment","summary":"Delete an assignment"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"No content, successful deletion","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1training~1{training_id}~1user~1{id}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"204","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/training-module/deleteanassignment"}],"panels":[]}]},"httpPath":"/api/v2/training/{training_id}/user/{id}"}],"content":{"contentType":"group","meta":{"name":"Training Module"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Training Module","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v2/training","summary":"List training modules","prefix":{"name":"get","color":"get"},"badges":[],"link":"/training-module/listtrainingmodules","deprecated":false},{"title":"/api/v2/training","summary":"Create a training module","prefix":{"name":"post","color":"post"},"badges":[],"link":"/training-module/createatrainingmodule","deprecated":false},{"title":"/api/v2/training/{id}","summary":"Read a training module","prefix":{"name":"get","color":"get"},"badges":[],"link":"/training-module/readatrainingmodule","deprecated":false},{"title":"/api/v2/training/{id}","summary":"Update a training module","prefix":{"name":"put","color":"put"},"badges":[],"link":"/training-module/updateatrainingmodule","deprecated":false},{"title":"/api/v2/training/{id}","summary":"Delete a training module","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/training-module/deleteatrainingmodule","deprecated":false},{"title":"/api/v2/training/{training_id}/user","summary":"List a module's assigned users","prefix":{"name":"get","color":"get"},"badges":[],"link":"/training-module/listamodulesassignedusers","deprecated":false},{"title":"/api/v2/training/{training_id}/user","summary":"Assign a module to a user","prefix":{"name":"post","color":"post"},"badges":[],"link":"/training-module/assignamoduletoauser","deprecated":false},{"title":"/api/v2/training/{training_id}/user","summary":"Assign a module to many users","prefix":{"name":"put","color":"put"},"badges":[],"link":"/training-module/assignamoduletomanyusers","deprecated":false},{"title":"/api/v2/training/{training_id}/user/{id}","summary":"Read an assignment","prefix":{"name":"get","color":"get"},"badges":[],"link":"/training-module/readanassignment","deprecated":false},{"title":"/api/v2/training/{training_id}/user/{id}","summary":"Update an assignment","prefix":{"name":"put","color":"put"},"badges":[],"link":"/training-module/updateanassignment","deprecated":false},{"title":"/api/v2/training/{training_id}/user/{id}","summary":"Delete an assignment","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/training-module/deleteanassignment","deprecated":false}]}]}]}]}},{"type":"group","label":"Headcount Module","link":"/api-docs/openapi/headcount-module","routeSlug":"/api-docs/openapi/headcount-module","items":[{"label":"List functional areas","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/headcount-module/listfunctionalareas","routeSlug":"/api-docs/openapi/headcount-module/listfunctionalareas","metadata":{"seo":{"title":"List functional areas","description":"Returns the functional areas the account holds - the groups its workforce isorganised into, each with a target headcount and the roles that sit under it."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listFunctionalAreas","name":"List functional areas","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1functionalarea/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List functional areas","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the functional areas the account holds - the groups its workforce is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"organised into, each with a target headcount and the roles that sit under it."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The listing is only paginated when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is supplied. Without it every match is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"returned as a flat array rather than in the paged envelope."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"per_page","in":"query","schemaId":"schema_262","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of results to return per page. The higher the number the longer the request may take."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is highly recommended to use this to avoid timeouts as your data grows."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate results."},"children":[]}]}]}]},{"name":"page","in":"query","schemaId":"schema_263","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The page of results to return. Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"per_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"results. If not specified, defaults to 1."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response's next_page_url will be null if there are no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"more pages."},"children":[]}]}]}]},{"name":"filter","in":"query","schemaId":"schema_264","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A filter to apply to the results. Declared as an array of objects, where each object"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contains an attr (attribute code), operator and value key. Examples:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=name&filter[0][operator]=like&filter[0][value]=luke"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=id&filter[0][operator]=>&filter[0][value]=265"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the filters documentation for more details on how to use this."},"children":[]}]}]}],"example":null},{"name":"sort_by","in":"query","schemaId":"schema_265","description":"The field to sort the results by. No ordering is applied unless you specify one, so\nrow order is not guaranteed. Always send it when paging through a list, otherwise\nrecords can repeat or be missed between pages.\nExample: id","example":null},{"name":"sort_order","in":"query","schemaId":"schema_266","description":"The direction to sort the results by. Can be 'asc' or 'desc', default is 'asc'.","example":null},{"name":"_locale","in":"query","schemaId":"schema_267","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The locale to use for the response. This primarily affects the results of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contain human-readable labels and terms, as well as locale-specific date formats.,"},"children":[]}]}]}]},{"name":"extras","in":"query","schemaId":"schema_331","description":"A list of extras to include in the response. These are objects or arrays that are not part of\nthe model's primary attributes, such as stats and counts.\nFor fast responses, avoid requesting them if you don't need them. "}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/headcount/functionalarea","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[{"name":"per_page","in":"query","required":false,"schemaId":"schema_262"},{"name":"page","in":"query","required":false,"schemaId":"schema_263"},{"name":"filter","in":"query","required":false,"schemaId":"schema_264"},{"name":"sort_by","in":"query","required":false,"schemaId":"schema_265"},{"name":"sort_order","in":"query","required":false,"schemaId":"schema_266"},{"name":"_locale","in":"query","required":false,"schemaId":"schema_267"},{"name":"extras","in":"query","required":false,"schemaId":"schema_331"}],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/headcount/functionalarea","href":"headcount-module/listfunctionalareas","openApiOperationId":"listFunctionalAreas","summary":"List functional areas"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_332"}},"schemaId":"schema_332"}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_332","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_332"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/headcount-module/listfunctionalareas"}],"panels":[]}]},"httpPath":"/api/v2/headcount/functionalarea"},{"label":"Create a functional area","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/headcount-module/createafunctionalarea","routeSlug":"/api-docs/openapi/headcount-module/createafunctionalarea","metadata":{"seo":{"title":"Create a functional area","description":"Sets up a new group to organise the workforce into, with a target headcount and,optionally, a set of conditions that keep its membership up to date on its own."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createAFunctionalArea","name":"Create a functional area","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1functionalarea/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a functional area","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sets up a new group to organise the workforce into, with a target headcount and,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"optionally, a set of conditions that keep its membership up to date on its own."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" has to be unique within the account and is stored in upper case whatever"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"case it is sent in. Switching "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"auto_update_mode"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on makes "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rules"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" mandatory - a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"create that turns it on without well-formed conditions is rejected."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The created group comes back with only the fields that were set on it"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", not the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"full record that reading it returns: anything left to its stored default is absent"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"rather than present and defaulted. Read the group back if you need its complete"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"state."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_333"}},"schemaId":"schema_333","pointer":"/paths/~1api~1v2~1headcount~1functionalarea/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/headcount/functionalarea","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_333"}},"responseCodes":["201","404"],"pointer":"/api/v2/headcount/functionalarea","href":"headcount-module/createafunctionalarea","openApiOperationId":"createAFunctionalArea","summary":"Create a functional area"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_333","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_333"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_334"}},"schemaId":"schema_334"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_334","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_334"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/headcount-module/createafunctionalarea"}],"panels":[]}]},"httpPath":"/api/v2/headcount/functionalarea"},{"label":"Read a functional area","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/headcount-module/readafunctionalarea","routeSlug":"/api-docs/openapi/headcount-module/readafunctionalarea","metadata":{"seo":{"title":"Read a functional area","description":"Returns one group with its target headcount, the type it is filed under, thetraining assigned to anyone who joins it, and the conditions that maintain itsmembership if automatic updating is switched on."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"readAFunctionalArea","name":"Read a functional area","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Read a functional area","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns one group with its target headcount, the type it is filed under, the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"training assigned to anyone who joins it, and the conditions that maintain its"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"membership if automatic updating is switched on."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"permissions.delete"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" reflects whether this particular group can be removed, which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"depends on whether roles are still recruiting under it."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the functional area.","required":true}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/headcount/functionalarea/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/v2/headcount/functionalarea/{id}","href":"headcount-module/readafunctionalarea","openApiOperationId":"readAFunctionalArea","summary":"Read a functional area"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_335"}},"schemaId":"schema_335"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_335","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_335"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/headcount-module/readafunctionalarea"}],"panels":[]}]},"httpPath":"/api/v2/headcount/functionalarea/{id}"},{"label":"Update a functional area","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/headcount-module/updateafunctionalarea","routeSlug":"/api-docs/openapi/headcount-module/updateafunctionalarea","metadata":{"seo":{"title":"Update a functional area","description":"Updates the fields supplied and returns the group in the same shape as reading it.Only the fields sent are touched, so an empty body is a valid request that changesnothing."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateAFunctionalArea","name":"Update a functional area","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a functional area","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Updates the fields supplied and returns the group in the same shape as reading it."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Only the fields sent are touched, so an empty body is a valid request that changes"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"nothing."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rules"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the exception, and it is worth reading before updating a group that"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"updates its membership automatically."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Omitting "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rules"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" clears the conditions"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"rather than leaving them alone, so on a group with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"auto_update_mode"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" switched on"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"an update that does not resend them is rejected and nothing changes. Send the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"conditions back on every update to such a group, or switch "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"auto_update_mode"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the same request."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Changing the conditions does not revisit anyone already in the group in the same"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"breath - membership is reconciled as the conditions are next applied."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the functional area.","required":true}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{id}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_336"}},"schemaId":"schema_336","pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v2/headcount/functionalarea/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_336"}},"responseCodes":["200","404"],"pointer":"/api/v2/headcount/functionalarea/{id}","href":"headcount-module/updateafunctionalarea","openApiOperationId":"updateAFunctionalArea","summary":"Update a functional area"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_336","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_336"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_335"}},"schemaId":"schema_335"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_335","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_335"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/headcount-module/updateafunctionalarea"}],"panels":[]}]},"httpPath":"/api/v2/headcount/functionalarea/{id}"},{"label":"Delete a functional area","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/headcount-module/deleteafunctionalarea","routeSlug":"/api-docs/openapi/headcount-module/deleteafunctionalarea","metadata":{"seo":{"title":"Delete a functional area","description":"Removes the group. The record is retained internally so past reporting is not lost,but the group can no longer be read or edited and no endpoint restores it."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteAFunctionalArea","name":"Delete a functional area","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete a functional area","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Removes the group. The record is retained internally so past reporting is not lost,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"but the group can no longer be read or edited and no endpoint restores it."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A group that still has roles recruiting under it cannot be deleted"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - remove or"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"reassign its roles first. The same applies to the account's built-in default group,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"which is not removable at all."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"200"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"messages"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field rather than an empty "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"204"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"messages"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" carries"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"anything the platform wants to tell you about the deletion and is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when there"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"is nothing to say."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the functional area.","required":true}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/v2/headcount/functionalarea/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/v2/headcount/functionalarea/{id}","href":"headcount-module/deleteafunctionalarea","openApiOperationId":"deleteAFunctionalArea","summary":"Delete a functional area"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_337"}},"schemaId":"schema_337"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{id}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_337","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_337"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/headcount-module/deleteafunctionalarea"}],"panels":[]}]},"httpPath":"/api/v2/headcount/functionalarea/{id}"},{"label":"List job titles","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/headcount-module/listjobtitles","routeSlug":"/api-docs/openapi/headcount-module/listjobtitles","metadata":{"seo":{"title":"List job titles","description":"Returns the roles recruiting under one functional area, each with the trainingassigned to whoever takes it on."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listJobTitles","name":"List job titles","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{functionalarea_id}~1jobtitle/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List job titles","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the roles recruiting under one functional area, each with the training"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"assigned to whoever takes it on."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The listing is only paginated when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is supplied. Without it every match is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"returned as a flat array rather than in the paged envelope."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"functionalarea_id","in":"path","schemaId":"schema_317","description":"The ID of the functional area.","required":true}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{functionalarea_id}~1jobtitle/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"per_page","in":"query","schemaId":"schema_262","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of results to return per page. The higher the number the longer the request may take."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is highly recommended to use this to avoid timeouts as your data grows."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate results."},"children":[]}]}]}]},{"name":"page","in":"query","schemaId":"schema_263","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The page of results to return. Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"per_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"results. If not specified, defaults to 1."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response's next_page_url will be null if there are no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"more pages."},"children":[]}]}]}]},{"name":"filter","in":"query","schemaId":"schema_264","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A filter to apply to the results. Declared as an array of objects, where each object"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contains an attr (attribute code), operator and value key. Examples:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=name&filter[0][operator]=like&filter[0][value]=luke"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=id&filter[0][operator]=>&filter[0][value]=265"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the filters documentation for more details on how to use this."},"children":[]}]}]}],"example":null},{"name":"sort_by","in":"query","schemaId":"schema_265","description":"The field to sort the results by. No ordering is applied unless you specify one, so\nrow order is not guaranteed. Always send it when paging through a list, otherwise\nrecords can repeat or be missed between pages.\nExample: id","example":null},{"name":"sort_order","in":"query","schemaId":"schema_266","description":"The direction to sort the results by. Can be 'asc' or 'desc', default is 'asc'.","example":null},{"name":"_locale","in":"query","schemaId":"schema_267","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The locale to use for the response. This primarily affects the results of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contain human-readable labels and terms, as well as locale-specific date formats.,"},"children":[]}]}]}]},{"name":"extras","in":"query","schemaId":"schema_331","description":"A list of extras to include in the response. These are objects or arrays that are not part of\nthe model's primary attributes, such as stats and counts.\nFor fast responses, avoid requesting them if you don't need them. "}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{functionalarea_id}~1jobtitle/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{functionalarea_id}~1jobtitle/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/headcount/functionalarea/{functionalarea_id}/jobtitle","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"functionalarea_id","in":"path","required":true,"schemaId":"schema_317"}],"query":[{"name":"per_page","in":"query","required":false,"schemaId":"schema_262"},{"name":"page","in":"query","required":false,"schemaId":"schema_263"},{"name":"filter","in":"query","required":false,"schemaId":"schema_264"},{"name":"sort_by","in":"query","required":false,"schemaId":"schema_265"},{"name":"sort_order","in":"query","required":false,"schemaId":"schema_266"},{"name":"_locale","in":"query","required":false,"schemaId":"schema_267"},{"name":"extras","in":"query","required":false,"schemaId":"schema_331"}],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/headcount/functionalarea/{functionalarea_id}/jobtitle","href":"headcount-module/listjobtitles","openApiOperationId":"listJobTitles","summary":"List job titles"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_338"}},"schemaId":"schema_338"}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{functionalarea_id}~1jobtitle/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_338","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_338"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/headcount-module/listjobtitles"}],"panels":[]}]},"httpPath":"/api/v2/headcount/functionalarea/{functionalarea_id}/jobtitle"},{"label":"Create a job title","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/headcount-module/createajobtitle","routeSlug":"/api-docs/openapi/headcount-module/createajobtitle","metadata":{"seo":{"title":"Create a job title","description":"Adds a role under the functional area named in the URL. The parent is taken fromthe URL, so it is not a body field and cannot be set by sending one."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createAJobTitle","name":"Create a job title","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{functionalarea_id}~1jobtitle/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a job title","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Adds a role under the functional area named in the URL. The parent is taken from"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the URL, so it is not a body field and cannot be set by sending one."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" has to be unique across the whole account, not just within this functional"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"area, and is stored in upper case whatever case it is sent in."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The created role comes back without "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"deleted_at"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", which reading it includes."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Everything else matches the read shape."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"functionalarea_id","in":"path","schemaId":"schema_317","description":"The ID of the functional area.","required":true}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{functionalarea_id}~1jobtitle/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{functionalarea_id}~1jobtitle/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_339"}},"schemaId":"schema_339","pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{functionalarea_id}~1jobtitle/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/headcount/functionalarea/{functionalarea_id}/jobtitle","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"functionalarea_id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_339"}},"responseCodes":["201","404"],"pointer":"/api/v2/headcount/functionalarea/{functionalarea_id}/jobtitle","href":"headcount-module/createajobtitle","openApiOperationId":"createAJobTitle","summary":"Create a job title"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_339","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_339"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_340"}},"schemaId":"schema_340"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{functionalarea_id}~1jobtitle/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_340","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_340"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/headcount-module/createajobtitle"}],"panels":[]}]},"httpPath":"/api/v2/headcount/functionalarea/{functionalarea_id}/jobtitle"},{"label":"Read a job title","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/headcount-module/readajobtitle","routeSlug":"/api-docs/openapi/headcount-module/readajobtitle","metadata":{"seo":{"title":"Read a job title","description":"Returns one role with its description and the training assigned to whoever takes iton. relations.functional_area carries the parent group in full, so a separate callis not needed to see which group the role belongs to."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"readAJobTitle","name":"Read a job title","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{functionalarea_id}~1jobtitle~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Read a job title","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns one role with its description and the training assigned to whoever takes it"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"on. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"relations.functional_area"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" carries the parent group in full, so a separate call"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"is not needed to see which group the role belongs to."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The role must belong to the functional area named in the URL; asking for one under"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"a different group is not found."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"functionalarea_id","in":"path","schemaId":"schema_317","description":"The ID of the functional area.","required":true},{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the job title.","required":true}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{functionalarea_id}~1jobtitle~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{functionalarea_id}~1jobtitle~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/headcount/functionalarea/{functionalarea_id}/jobtitle/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"functionalarea_id","in":"path","required":true,"schemaId":"schema_317"},{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/v2/headcount/functionalarea/{functionalarea_id}/jobtitle/{id}","href":"headcount-module/readajobtitle","openApiOperationId":"readAJobTitle","summary":"Read a job title"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_340"}},"schemaId":"schema_340"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{functionalarea_id}~1jobtitle~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_340","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_340"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/headcount-module/readajobtitle"}],"panels":[]}]},"httpPath":"/api/v2/headcount/functionalarea/{functionalarea_id}/jobtitle/{id}"},{"label":"Update a job title","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/headcount-module/updateajobtitle","routeSlug":"/api-docs/openapi/headcount-module/updateajobtitle","metadata":{"seo":{"title":"Update a job title","description":"Updates the fields supplied and returns the role in the same shape as reading it.Only the fields sent are touched, so an empty body is a valid request that changesnothing, and omitting training_ids leaves the assigned training alone rather thanclearing it."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateAJobTitle","name":"Update a job title","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{functionalarea_id}~1jobtitle~1{id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a job title","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Updates the fields supplied and returns the role in the same shape as reading it."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Only the fields sent are touched, so an empty body is a valid request that changes"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"nothing, and omitting "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"training_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" leaves the assigned training alone rather than"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"clearing it."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The role stays under the functional area it was created in; this endpoint does not"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"move it."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"functionalarea_id","in":"path","schemaId":"schema_317","description":"The ID of the functional area.","required":true},{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the job title.","required":true}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{functionalarea_id}~1jobtitle~1{id}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{functionalarea_id}~1jobtitle~1{id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_341"}},"schemaId":"schema_341","pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{functionalarea_id}~1jobtitle~1{id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v2/headcount/functionalarea/{functionalarea_id}/jobtitle/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"functionalarea_id","in":"path","required":true,"schemaId":"schema_317"},{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_341"}},"responseCodes":["200","404"],"pointer":"/api/v2/headcount/functionalarea/{functionalarea_id}/jobtitle/{id}","href":"headcount-module/updateajobtitle","openApiOperationId":"updateAJobTitle","summary":"Update a job title"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_341","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_341"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_340"}},"schemaId":"schema_340"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{functionalarea_id}~1jobtitle~1{id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_340","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_340"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/headcount-module/updateajobtitle"}],"panels":[]}]},"httpPath":"/api/v2/headcount/functionalarea/{functionalarea_id}/jobtitle/{id}"},{"label":"Delete a job title","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/headcount-module/deleteajobtitle","routeSlug":"/api-docs/openapi/headcount-module/deleteajobtitle","metadata":{"seo":{"title":"Delete a job title","description":"Removes the role. The record is retained internally so past reporting is not lost,but the role can no longer be read or edited and no endpoint restores it."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteAJobTitle","name":"Delete a job title","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{functionalarea_id}~1jobtitle~1{id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete a job title","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Removes the role. The record is retained internally so past reporting is not lost,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"but the role can no longer be read or edited and no endpoint restores it."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A role that is still recruiting cannot be deleted"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - close or reassign its"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"recruitment first."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"200"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"messages"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field rather than an empty "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"204"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"messages"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" carries"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"anything the platform wants to tell you about the deletion and is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when there"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"is nothing to say."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"functionalarea_id","in":"path","schemaId":"schema_317","description":"The ID of the functional area.","required":true},{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the job title.","required":true}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{functionalarea_id}~1jobtitle~1{id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{functionalarea_id}~1jobtitle~1{id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/v2/headcount/functionalarea/{functionalarea_id}/jobtitle/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"functionalarea_id","in":"path","required":true,"schemaId":"schema_317"},{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/v2/headcount/functionalarea/{functionalarea_id}/jobtitle/{id}","href":"headcount-module/deleteajobtitle","openApiOperationId":"deleteAJobTitle","summary":"Delete a job title"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_337"}},"schemaId":"schema_337"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{functionalarea_id}~1jobtitle~1{id}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_337","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_337"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/headcount-module/deleteajobtitle"}],"panels":[]}]},"httpPath":"/api/v2/headcount/functionalarea/{functionalarea_id}/jobtitle/{id}"},{"label":"List functional area types","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/headcount-module/listfunctionalareatypes","routeSlug":"/api-docs/openapi/headcount-module/listfunctionalareatypes","metadata":{"seo":{"title":"List functional area types","description":"Returns the categories the account files its functional areas under, in the ordersort_order puts them."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listFunctionalAreaTypes","name":"List functional area types","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1type/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List functional area types","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the categories the account files its functional areas under, in the order"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sort_order"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" puts them."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The listing is only paginated when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is supplied. Without it every match is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"returned as a flat array rather than in the paged envelope."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"per_page","in":"query","schemaId":"schema_262","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of results to return per page. The higher the number the longer the request may take."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is highly recommended to use this to avoid timeouts as your data grows."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate results."},"children":[]}]}]}]},{"name":"page","in":"query","schemaId":"schema_263","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The page of results to return. Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"per_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"results. If not specified, defaults to 1."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response's next_page_url will be null if there are no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"more pages."},"children":[]}]}]}]},{"name":"filter","in":"query","schemaId":"schema_264","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A filter to apply to the results. Declared as an array of objects, where each object"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contains an attr (attribute code), operator and value key. Examples:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=name&filter[0][operator]=like&filter[0][value]=luke"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=id&filter[0][operator]=>&filter[0][value]=265"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the filters documentation for more details on how to use this."},"children":[]}]}]}],"example":null},{"name":"sort_by","in":"query","schemaId":"schema_265","description":"The field to sort the results by. No ordering is applied unless you specify one, so\nrow order is not guaranteed. Always send it when paging through a list, otherwise\nrecords can repeat or be missed between pages.\nExample: id","example":null},{"name":"sort_order","in":"query","schemaId":"schema_266","description":"The direction to sort the results by. Can be 'asc' or 'desc', default is 'asc'.","example":null},{"name":"_locale","in":"query","schemaId":"schema_267","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The locale to use for the response. This primarily affects the results of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contain human-readable labels and terms, as well as locale-specific date formats.,"},"children":[]}]}]}]}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1type/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1type/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/headcount/functionalarea/type","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[{"name":"per_page","in":"query","required":false,"schemaId":"schema_262"},{"name":"page","in":"query","required":false,"schemaId":"schema_263"},{"name":"filter","in":"query","required":false,"schemaId":"schema_264"},{"name":"sort_by","in":"query","required":false,"schemaId":"schema_265"},{"name":"sort_order","in":"query","required":false,"schemaId":"schema_266"},{"name":"_locale","in":"query","required":false,"schemaId":"schema_267"}],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/headcount/functionalarea/type","href":"headcount-module/listfunctionalareatypes","openApiOperationId":"listFunctionalAreaTypes","summary":"List functional area types"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_342"}},"schemaId":"schema_342"}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1type/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_342","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_342"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/headcount-module/listfunctionalareatypes"}],"panels":[]}]},"httpPath":"/api/v2/headcount/functionalarea/type"},{"label":"Create a functional area type","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/headcount-module/createafunctionalareatype","routeSlug":"/api-docs/openapi/headcount-module/createafunctionalareatype","metadata":{"seo":{"title":"Create a functional area type","description":"Adds a category that functional areas can be filed under. Point a functional areaat it with headcount_functional_area_type_id on the create or update endpoint forthat area."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createAFunctionalAreaType","name":"Create a functional area type","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1type/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a functional area type","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Adds a category that functional areas can be filed under. Point a functional area"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"at it with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"headcount_functional_area_type_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on the create or update endpoint for"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"that area."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A type created without "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sort_order"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" comes back without that field"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", rather than"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"with its stored default of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Read the type back if you need its complete state."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1type/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_343"}},"schemaId":"schema_343","pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1type/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/headcount/functionalarea/type","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_343"}},"responseCodes":["201","404"],"pointer":"/api/v2/headcount/functionalarea/type","href":"headcount-module/createafunctionalareatype","openApiOperationId":"createAFunctionalAreaType","summary":"Create a functional area type"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_343","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_343"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_344"}},"schemaId":"schema_344"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1type/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_344","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_344"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/headcount-module/createafunctionalareatype"}],"panels":[]}]},"httpPath":"/api/v2/headcount/functionalarea/type"},{"label":"Read a functional area type","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/headcount-module/readafunctionalareatype","routeSlug":"/api-docs/openapi/headcount-module/readafunctionalareatype","metadata":{"seo":{"title":"Read a functional area type","description":"Returns one category with its name and sort position."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"readAFunctionalAreaType","name":"Read a functional area type","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1type~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Read a functional area type","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns one category with its name and sort position."},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the functional area type.","required":true}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1type~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1type~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/headcount/functionalarea/type/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/v2/headcount/functionalarea/type/{id}","href":"headcount-module/readafunctionalareatype","openApiOperationId":"readAFunctionalAreaType","summary":"Read a functional area type"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_344"}},"schemaId":"schema_344"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1type~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_344","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_344"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/headcount-module/readafunctionalareatype"}],"panels":[]}]},"httpPath":"/api/v2/headcount/functionalarea/type/{id}"},{"label":"Update a functional area type","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/headcount-module/updateafunctionalareatype","routeSlug":"/api-docs/openapi/headcount-module/updateafunctionalareatype","metadata":{"seo":{"title":"Update a functional area type","description":"Updates the fields supplied and returns the type in the same shape as reading it. Only the fields sent are touched, so an empty body is a valid request that changes nothing."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateAFunctionalAreaType","name":"Update a functional area type","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1type~1{id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a functional area type","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Updates the fields supplied and returns the type in the same shape as reading it.\nOnly the fields sent are touched, so an empty body is a valid request that changes\nnothing.\n\nRenaming a type does not affect which functional areas are filed under it."},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the functional area type.","required":true}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1type~1{id}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1type~1{id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_345"}},"schemaId":"schema_345","pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1type~1{id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v2/headcount/functionalarea/type/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_345"}},"responseCodes":["200","404"],"pointer":"/api/v2/headcount/functionalarea/type/{id}","href":"headcount-module/updateafunctionalareatype","openApiOperationId":"updateAFunctionalAreaType","summary":"Update a functional area type"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_345","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_345"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_344"}},"schemaId":"schema_344"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1type~1{id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_344","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_344"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/headcount-module/updateafunctionalareatype"}],"panels":[]}]},"httpPath":"/api/v2/headcount/functionalarea/type/{id}"},{"label":"Delete a functional area type","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/headcount-module/deleteafunctionalareatype","routeSlug":"/api-docs/openapi/headcount-module/deleteafunctionalareatype","metadata":{"seo":{"title":"Delete a functional area type","description":"Removes the category. The record is retained internally so past reporting is notlost, but the type can no longer be read or edited and no endpoint restores it."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteAFunctionalAreaType","name":"Delete a functional area type","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1type~1{id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete a functional area type","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Removes the category. The record is retained internally so past reporting is not"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"lost, but the type can no longer be read or edited and no endpoint restores it."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Functional areas filed under it are "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"not"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" deleted and keep pointing at the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"removed type, so reassign them first if they should stay categorised."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the functional area type.","required":true}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1type~1{id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1type~1{id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/v2/headcount/functionalarea/type/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["204","404"],"pointer":"/api/v2/headcount/functionalarea/type/{id}","href":"headcount-module/deleteafunctionalareatype","openApiOperationId":"deleteAFunctionalAreaType","summary":"Delete a functional area type"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"No content, successful deletion","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1type~1{id}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"204","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/headcount-module/deleteafunctionalareatype"}],"panels":[]}]},"httpPath":"/api/v2/headcount/functionalarea/type/{id}"},{"label":"Add people to a functional area","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/headcount-module/addpeopletoafunctionalarea","routeSlug":"/api-docs/openapi/headcount-module/addpeopletoafunctionalarea","metadata":{"seo":{"title":"Add people to a functional area","description":"Adds a list of people to the functional area named in the URL, all with the samemembership status. The work is queued rather than done while you wait, so a 200means the request was accepted, not that anyone has been added yet."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"addPeopleToAFunctionalArea","name":"Add people to a functional area","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{functionalarea_id}~1user~1mass-create/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Add people to a functional area","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Adds a list of people to the functional area named in the URL, all with the same"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"membership status. The work is queued rather than done while you wait, so a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"200"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"means the request was accepted, not that anyone has been added yet."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send this request as form-encoded parameters, not as a JSON body."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" A JSON body"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"is not read for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and the request is reported as not found."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"People who cannot be added are skipped rather than reported: IDs that do not"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"resolve, people in another account, and anyone already in the group. The response"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"does not say how many were added, and the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"queue"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" value it returns is a correlation"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"reference that no endpoint resolves - "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"there is nothing to poll"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Confirm the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"outcome by listing the group's members."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"functionalarea_id","in":"path","schemaId":"schema_317","description":"The ID of the functional area.","required":true}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{functionalarea_id}~1user~1mass-create/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{functionalarea_id}~1user~1mass-create/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_346"}},"schemaId":"schema_346","pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{functionalarea_id}~1user~1mass-create/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/headcount/functionalarea/{functionalarea_id}/user/mass-create","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"functionalarea_id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_346"}},"responseCodes":["200"],"pointer":"/api/v2/headcount/functionalarea/{functionalarea_id}/user/mass-create","href":"headcount-module/addpeopletoafunctionalarea","openApiOperationId":"addPeopleToAFunctionalArea","summary":"Add people to a functional area"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_346","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_346"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_284"}},"schemaId":"schema_284"}],"pointer":"/paths/~1api~1v2~1headcount~1functionalarea~1{functionalarea_id}~1user~1mass-create/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_284","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_284"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/headcount-module/addpeopletoafunctionalarea"}],"panels":[]}]},"httpPath":"/api/v2/headcount/functionalarea/{functionalarea_id}/user/mass-create"},{"label":"List locations","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/headcount-module/listlocations","routeSlug":"/api-docs/openapi/headcount-module/listlocations","metadata":{"seo":{"title":"List locations","description":"Returns the locations the account holds - the places it recruits and rosters peopleto, each of which groups one or more venues."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listLocations","name":"List locations","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1location/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List locations","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the locations the account holds - the places it recruits and rosters people"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"to, each of which groups one or more venues."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The listing is only paginated when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is supplied. Without it every match is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"returned as a flat array rather than in the paged envelope."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"per_page","in":"query","schemaId":"schema_262","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of results to return per page. The higher the number the longer the request may take."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is highly recommended to use this to avoid timeouts as your data grows."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate results."},"children":[]}]}]}]},{"name":"page","in":"query","schemaId":"schema_263","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The page of results to return. Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"per_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"results. If not specified, defaults to 1."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response's next_page_url will be null if there are no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"more pages."},"children":[]}]}]}]},{"name":"filter","in":"query","schemaId":"schema_264","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A filter to apply to the results. Declared as an array of objects, where each object"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contains an attr (attribute code), operator and value key. Examples:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=name&filter[0][operator]=like&filter[0][value]=luke"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=id&filter[0][operator]=>&filter[0][value]=265"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the filters documentation for more details on how to use this."},"children":[]}]}]}],"example":null},{"name":"sort_by","in":"query","schemaId":"schema_265","description":"The field to sort the results by. No ordering is applied unless you specify one, so\nrow order is not guaranteed. Always send it when paging through a list, otherwise\nrecords can repeat or be missed between pages.\nExample: id","example":null},{"name":"sort_order","in":"query","schemaId":"schema_266","description":"The direction to sort the results by. Can be 'asc' or 'desc', default is 'asc'.","example":null},{"name":"_locale","in":"query","schemaId":"schema_267","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The locale to use for the response. This primarily affects the results of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contain human-readable labels and terms, as well as locale-specific date formats.,"},"children":[]}]}]}]},{"name":"extras","in":"query","schemaId":"schema_331","description":"A list of extras to include in the response. These are objects or arrays that are not part of\nthe model's primary attributes, such as stats and counts.\nFor fast responses, avoid requesting them if you don't need them. "}],"pointer":"/paths/~1api~1v2~1headcount~1location/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1location/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/headcount/location","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[{"name":"per_page","in":"query","required":false,"schemaId":"schema_262"},{"name":"page","in":"query","required":false,"schemaId":"schema_263"},{"name":"filter","in":"query","required":false,"schemaId":"schema_264"},{"name":"sort_by","in":"query","required":false,"schemaId":"schema_265"},{"name":"sort_order","in":"query","required":false,"schemaId":"schema_266"},{"name":"_locale","in":"query","required":false,"schemaId":"schema_267"},{"name":"extras","in":"query","required":false,"schemaId":"schema_331"}],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/headcount/location","href":"headcount-module/listlocations","openApiOperationId":"listLocations","summary":"List locations"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_347"}},"schemaId":"schema_347"}],"pointer":"/paths/~1api~1v2~1headcount~1location/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_347","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_347"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/headcount-module/listlocations"}],"panels":[]}]},"httpPath":"/api/v2/headcount/location"},{"label":"Create a location","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/headcount-module/createalocation","routeSlug":"/api-docs/openapi/headcount-module/createalocation","metadata":{"seo":{"title":"Create a location","description":"Sets up a new place to recruit and roster people to. Venues are then created underit, and roles are advertised against those venues rather than against the locationitself."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createALocation","name":"Create a location","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1location/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a location","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sets up a new place to recruit and roster people to. Venues are then created under"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"it, and roles are advertised against those venues rather than against the location"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"itself."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" has to be unique within the account and is stored in upper case whatever case"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"it is sent in, so "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"mainstadium"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"MAINSTADIUM"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are the same code."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The created location comes back with only the fields that were set on it"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", not"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the full record that reading it returns: anything left to its stored default is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"absent rather than present and defaulted. Read the location back if you need its"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"complete state."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1location/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_348"}},"schemaId":"schema_348","pointer":"/paths/~1api~1v2~1headcount~1location/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/headcount/location","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_348"}},"responseCodes":["201","404"],"pointer":"/api/v2/headcount/location","href":"headcount-module/createalocation","openApiOperationId":"createALocation","summary":"Create a location"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_348","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_348"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_349"}},"schemaId":"schema_349"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1headcount~1location/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_349","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_349"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/headcount-module/createalocation"}],"panels":[]}]},"httpPath":"/api/v2/headcount/location"},{"label":"Read a location","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/headcount-module/readalocation","routeSlug":"/api-docs/openapi/headcount-module/readalocation","metadata":{"seo":{"title":"Read a location","description":"Returns one location with its code, the type it is filed under and the trainingassigned to anyone who accepts a role there."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"readALocation","name":"Read a location","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1location~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Read a location","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns one location with its code, the type it is filed under and the training"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"assigned to anyone who accepts a role there."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"permissions.delete"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" reflects whether this particular location can be removed, which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"depends on whether roles are still recruiting at its venues."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the location.","required":true}],"pointer":"/paths/~1api~1v2~1headcount~1location~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1location~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/headcount/location/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/v2/headcount/location/{id}","href":"headcount-module/readalocation","openApiOperationId":"readALocation","summary":"Read a location"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_350"}},"schemaId":"schema_350"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1headcount~1location~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_350","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_350"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/headcount-module/readalocation"}],"panels":[]}]},"httpPath":"/api/v2/headcount/location/{id}"},{"label":"Update a location","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/headcount-module/updatealocation","routeSlug":"/api-docs/openapi/headcount-module/updatealocation","metadata":{"seo":{"title":"Update a location","description":"Updates the fields supplied and returns the location in the same shape as reading it. Only the fields sent are touched, so an empty body is a valid request that changes nothing."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateALocation","name":"Update a location","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1location~1{id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a location","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Updates the fields supplied and returns the location in the same shape as reading\nit. Only the fields sent are touched, so an empty body is a valid request that\nchanges nothing.\n\nRenaming a location does not affect the venues under it or the roles advertised at\nthose venues."},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the location.","required":true}],"pointer":"/paths/~1api~1v2~1headcount~1location~1{id}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1location~1{id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_351"}},"schemaId":"schema_351","pointer":"/paths/~1api~1v2~1headcount~1location~1{id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v2/headcount/location/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_351"}},"responseCodes":["200","404"],"pointer":"/api/v2/headcount/location/{id}","href":"headcount-module/updatealocation","openApiOperationId":"updateALocation","summary":"Update a location"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_351","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_351"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_350"}},"schemaId":"schema_350"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1headcount~1location~1{id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_350","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_350"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/headcount-module/updatealocation"}],"panels":[]}]},"httpPath":"/api/v2/headcount/location/{id}"},{"label":"Delete a location","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/headcount-module/deletealocation","routeSlug":"/api-docs/openapi/headcount-module/deletealocation","metadata":{"seo":{"title":"Delete a location","description":"Removes the location. The record is retained internally so past reporting is notlost, but the location can no longer be read or edited and no endpoint restores it."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteALocation","name":"Delete a location","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1location~1{id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete a location","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Removes the location. The record is retained internally so past reporting is not"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"lost, but the location can no longer be read or edited and no endpoint restores it."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A location with roles still recruiting at any of its venues cannot be deleted"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" -"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"remove or reassign those roles first. The same applies to the account's built-in"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"default location, which is not removable at all."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The venues under it are not deleted, but they do become unreachable"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": every venue"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"endpoint resolves a venue through its location, so once the location is gone its"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"venues stop appearing in venue listings and can no longer be read, updated or"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"removed. Move or delete the venues first if you need them to stay available."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"200"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"messages"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field rather than an empty "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"204"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"messages"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" carries"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"anything the platform wants to tell you about the deletion and is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when there"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"is nothing to say."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the location.","required":true}],"pointer":"/paths/~1api~1v2~1headcount~1location~1{id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1location~1{id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/v2/headcount/location/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/v2/headcount/location/{id}","href":"headcount-module/deletealocation","openApiOperationId":"deleteALocation","summary":"Delete a location"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_337"}},"schemaId":"schema_337"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1headcount~1location~1{id}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_337","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_337"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/headcount-module/deletealocation"}],"panels":[]}]},"httpPath":"/api/v2/headcount/location/{id}"},{"label":"List a location's venues","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/headcount-module/listalocationsvenues","routeSlug":"/api-docs/openapi/headcount-module/listalocationsvenues","metadata":{"seo":{"title":"List a location's venues","description":"Returns the venues filed under one location - the addressable places within it thatroles are advertised at."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listALocationsVenues","name":"List a location's venues","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1location~1{location_id}~1venue/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List a location's venues","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the venues filed under one location - the addressable places within it that"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"roles are advertised at."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The listing is only paginated when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is supplied. Without it every match is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"returned as a flat array rather than in the paged envelope."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"location_id","in":"path","schemaId":"schema_317","description":"The ID of the location.","required":true}],"pointer":"/paths/~1api~1v2~1headcount~1location~1{location_id}~1venue/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"per_page","in":"query","schemaId":"schema_262","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of results to return per page. The higher the number the longer the request may take."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is highly recommended to use this to avoid timeouts as your data grows."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate results."},"children":[]}]}]}]},{"name":"page","in":"query","schemaId":"schema_263","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The page of results to return. Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"per_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"results. If not specified, defaults to 1."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response's next_page_url will be null if there are no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"more pages."},"children":[]}]}]}]},{"name":"filter","in":"query","schemaId":"schema_264","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A filter to apply to the results. Declared as an array of objects, where each object"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contains an attr (attribute code), operator and value key. Examples:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=name&filter[0][operator]=like&filter[0][value]=luke"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=id&filter[0][operator]=>&filter[0][value]=265"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the filters documentation for more details on how to use this."},"children":[]}]}]}],"example":null},{"name":"sort_by","in":"query","schemaId":"schema_265","description":"The field to sort the results by. No ordering is applied unless you specify one, so\nrow order is not guaranteed. Always send it when paging through a list, otherwise\nrecords can repeat or be missed between pages.\nExample: id","example":null},{"name":"sort_order","in":"query","schemaId":"schema_266","description":"The direction to sort the results by. Can be 'asc' or 'desc', default is 'asc'.","example":null},{"name":"_locale","in":"query","schemaId":"schema_267","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The locale to use for the response. This primarily affects the results of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contain human-readable labels and terms, as well as locale-specific date formats.,"},"children":[]}]}]}]},{"name":"extras","in":"query","schemaId":"schema_331","description":"A list of extras to include in the response. These are objects or arrays that are not part of\nthe model's primary attributes, such as stats and counts.\nFor fast responses, avoid requesting them if you don't need them. "}],"pointer":"/paths/~1api~1v2~1headcount~1location~1{location_id}~1venue/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1location~1{location_id}~1venue/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/headcount/location/{location_id}/venue","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"location_id","in":"path","required":true,"schemaId":"schema_317"}],"query":[{"name":"per_page","in":"query","required":false,"schemaId":"schema_262"},{"name":"page","in":"query","required":false,"schemaId":"schema_263"},{"name":"filter","in":"query","required":false,"schemaId":"schema_264"},{"name":"sort_by","in":"query","required":false,"schemaId":"schema_265"},{"name":"sort_order","in":"query","required":false,"schemaId":"schema_266"},{"name":"_locale","in":"query","required":false,"schemaId":"schema_267"},{"name":"extras","in":"query","required":false,"schemaId":"schema_331"}],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/headcount/location/{location_id}/venue","href":"headcount-module/listalocationsvenues","openApiOperationId":"listALocationsVenues","summary":"List a location's venues"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_352"}},"schemaId":"schema_352"}],"pointer":"/paths/~1api~1v2~1headcount~1location~1{location_id}~1venue/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_352","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_352"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/headcount-module/listalocationsvenues"}],"panels":[]}]},"httpPath":"/api/v2/headcount/location/{location_id}/venue"},{"label":"Create a venue","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/headcount-module/createavenue","routeSlug":"/api-docs/openapi/headcount-module/createavenue","metadata":{"seo":{"title":"Create a venue","description":"Adds an addressable place under the location in the path. Roles are advertisedagainst venues rather than against the location itself, so a location needs at leastone before it can be recruited for."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createAVenue","name":"Create a venue","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1location~1{location_id}~1venue/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a venue","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Adds an addressable place under the location in the path. Roles are advertised"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"against venues rather than against the location itself, so a location needs at least"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"one before it can be recruited for."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"address"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" unless the venue is virtual. An address is not mandatory - a venue can"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"be created without one and given it later - but a venue with no address and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"is_virtual"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" unset is excluded from proximity searches until one is added."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"description"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not read on create."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" It is accepted by the update endpoint only;"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"a create that sends it returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"201"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with the description unset. Add it in a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"follow-up update."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The created venue comes back with only the fields that were set on it"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", not the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"full record that reading it returns. Read the venue back if you need its complete"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"state."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"location_id","in":"path","schemaId":"schema_317","description":"The ID of the location.","required":true}],"pointer":"/paths/~1api~1v2~1headcount~1location~1{location_id}~1venue/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1location~1{location_id}~1venue/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_353"}},"schemaId":"schema_353","pointer":"/paths/~1api~1v2~1headcount~1location~1{location_id}~1venue/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/headcount/location/{location_id}/venue","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"location_id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_353"}},"responseCodes":["201","404"],"pointer":"/api/v2/headcount/location/{location_id}/venue","href":"headcount-module/createavenue","openApiOperationId":"createAVenue","summary":"Create a venue"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_353","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_353"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_354"}},"schemaId":"schema_354"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1headcount~1location~1{location_id}~1venue/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_354","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_354"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/headcount-module/createavenue"}],"panels":[]}]},"httpPath":"/api/v2/headcount/location/{location_id}/venue"},{"label":"Read a venue","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/headcount-module/readavenue","routeSlug":"/api-docs/openapi/headcount-module/readavenue","metadata":{"seo":{"title":"Read a venue","description":"Returns one venue with its address, the training assigned to anyone who accepts arole there, and the location it belongs to. nice carries the address pre-formattedfor display, both as a block and on one line."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"readAVenue","name":"Read a venue","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1location~1{location_id}~1venue~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Read a venue","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns one venue with its address, the training assigned to anyone who accepts a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"role there, and the location it belongs to. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" carries the address pre-formatted"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"for display, both as a block and on one line."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The venue has to belong to the location in the path."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"permissions.delete"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" reflects whether this particular venue can be removed, which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"depends on whether roles are still recruiting at it."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"location_id","in":"path","schemaId":"schema_317","description":"The ID of the location.","required":true},{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the venue.","required":true}],"pointer":"/paths/~1api~1v2~1headcount~1location~1{location_id}~1venue~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1location~1{location_id}~1venue~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/headcount/location/{location_id}/venue/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"location_id","in":"path","required":true,"schemaId":"schema_317"},{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/v2/headcount/location/{location_id}/venue/{id}","href":"headcount-module/readavenue","openApiOperationId":"readAVenue","summary":"Read a venue"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_355"}},"schemaId":"schema_355"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1headcount~1location~1{location_id}~1venue~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_355","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_355"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/headcount-module/readavenue"}],"panels":[]}]},"httpPath":"/api/v2/headcount/location/{location_id}/venue/{id}"},{"label":"Update a venue","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/headcount-module/updateavenue","routeSlug":"/api-docs/openapi/headcount-module/updateavenue","metadata":{"seo":{"title":"Update a venue","description":"Updates the fields supplied and returns the venue. Only the fields sent are touched,so an empty body is a valid request that changes nothing."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateAVenue","name":"Update a venue","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1location~1{location_id}~1venue~1{id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a venue","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Updates the fields supplied and returns the venue. Only the fields sent are touched,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"so an empty body is a valid request that changes nothing."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sending "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"address"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" replaces the address already held rather than merging into it, so"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"send the whole address every time. Sending "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"is_virtual"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" as true detaches the address"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"instead, and the response to that request still shows the old address even though it"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"is gone - read the venue back to see its settled state."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A venue stays under the location it was created in; this endpoint does not move it."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"location_id","in":"path","schemaId":"schema_317","description":"The ID of the location.","required":true},{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the venue.","required":true}],"pointer":"/paths/~1api~1v2~1headcount~1location~1{location_id}~1venue~1{id}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1location~1{location_id}~1venue~1{id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_356"}},"schemaId":"schema_356","pointer":"/paths/~1api~1v2~1headcount~1location~1{location_id}~1venue~1{id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v2/headcount/location/{location_id}/venue/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"location_id","in":"path","required":true,"schemaId":"schema_317"},{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_356"}},"responseCodes":["200","404"],"pointer":"/api/v2/headcount/location/{location_id}/venue/{id}","href":"headcount-module/updateavenue","openApiOperationId":"updateAVenue","summary":"Update a venue"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_356","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_356"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_355"}},"schemaId":"schema_355"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1headcount~1location~1{location_id}~1venue~1{id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_355","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_355"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/headcount-module/updateavenue"}],"panels":[]}]},"httpPath":"/api/v2/headcount/location/{location_id}/venue/{id}"},{"label":"Delete a venue","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/headcount-module/deleteavenue","routeSlug":"/api-docs/openapi/headcount-module/deleteavenue","metadata":{"seo":{"title":"Delete a venue","description":"Removes the venue. The record is retained internally so past reporting is not lost,but the venue can no longer be read or edited and no endpoint restores it."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteAVenue","name":"Delete a venue","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1location~1{location_id}~1venue~1{id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete a venue","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Removes the venue. The record is retained internally so past reporting is not lost,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"but the venue can no longer be read or edited and no endpoint restores it."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A venue with roles still recruiting at it cannot be deleted"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - remove or reassign"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"those roles first. The same applies to the account's built-in default venue, which is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"not removable at all."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"200"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"messages"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field rather than an empty "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"204"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"messages"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" carries"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"anything the platform wants to tell you about the deletion and is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when there is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"nothing to say."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"location_id","in":"path","schemaId":"schema_317","description":"The ID of the location.","required":true},{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the venue.","required":true}],"pointer":"/paths/~1api~1v2~1headcount~1location~1{location_id}~1venue~1{id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1location~1{location_id}~1venue~1{id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/v2/headcount/location/{location_id}/venue/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"location_id","in":"path","required":true,"schemaId":"schema_317"},{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/v2/headcount/location/{location_id}/venue/{id}","href":"headcount-module/deleteavenue","openApiOperationId":"deleteAVenue","summary":"Delete a venue"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_337"}},"schemaId":"schema_337"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1headcount~1location~1{location_id}~1venue~1{id}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_337","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_337"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/headcount-module/deleteavenue"}],"panels":[]}]},"httpPath":"/api/v2/headcount/location/{location_id}/venue/{id}"},{"label":"List location types","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/headcount-module/listlocationtypes","routeSlug":"/api-docs/openapi/headcount-module/listlocationtypes","metadata":{"seo":{"title":"List location types","description":"Returns the categories the account files its locations under, in the ordersort_order puts them."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listLocationTypes","name":"List location types","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1location~1type/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List location types","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the categories the account files its locations under, in the order"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sort_order"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" puts them."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The listing is only paginated when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is supplied. Without it every match is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"returned as a flat array rather than in the paged envelope."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"per_page","in":"query","schemaId":"schema_262","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of results to return per page. The higher the number the longer the request may take."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is highly recommended to use this to avoid timeouts as your data grows."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate results."},"children":[]}]}]}]},{"name":"page","in":"query","schemaId":"schema_263","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The page of results to return. Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"per_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"results. If not specified, defaults to 1."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response's next_page_url will be null if there are no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"more pages."},"children":[]}]}]}]},{"name":"filter","in":"query","schemaId":"schema_264","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A filter to apply to the results. Declared as an array of objects, where each object"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contains an attr (attribute code), operator and value key. Examples:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=name&filter[0][operator]=like&filter[0][value]=luke"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=id&filter[0][operator]=>&filter[0][value]=265"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the filters documentation for more details on how to use this."},"children":[]}]}]}],"example":null},{"name":"sort_by","in":"query","schemaId":"schema_265","description":"The field to sort the results by. No ordering is applied unless you specify one, so\nrow order is not guaranteed. Always send it when paging through a list, otherwise\nrecords can repeat or be missed between pages.\nExample: id","example":null},{"name":"sort_order","in":"query","schemaId":"schema_266","description":"The direction to sort the results by. Can be 'asc' or 'desc', default is 'asc'.","example":null},{"name":"_locale","in":"query","schemaId":"schema_267","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The locale to use for the response. This primarily affects the results of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contain human-readable labels and terms, as well as locale-specific date formats.,"},"children":[]}]}]}]}],"pointer":"/paths/~1api~1v2~1headcount~1location~1type/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1location~1type/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/headcount/location/type","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[{"name":"per_page","in":"query","required":false,"schemaId":"schema_262"},{"name":"page","in":"query","required":false,"schemaId":"schema_263"},{"name":"filter","in":"query","required":false,"schemaId":"schema_264"},{"name":"sort_by","in":"query","required":false,"schemaId":"schema_265"},{"name":"sort_order","in":"query","required":false,"schemaId":"schema_266"},{"name":"_locale","in":"query","required":false,"schemaId":"schema_267"}],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/headcount/location/type","href":"headcount-module/listlocationtypes","openApiOperationId":"listLocationTypes","summary":"List location types"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_357"}},"schemaId":"schema_357"}],"pointer":"/paths/~1api~1v2~1headcount~1location~1type/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_357","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_357"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/headcount-module/listlocationtypes"}],"panels":[]}]},"httpPath":"/api/v2/headcount/location/type"},{"label":"Create a location type","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/headcount-module/createalocationtype","routeSlug":"/api-docs/openapi/headcount-module/createalocationtype","metadata":{"seo":{"title":"Create a location type","description":"Adds a category that locations can be filed under. Point a location at it withheadcount_location_type_id on the create or update endpoint for that location."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createALocationType","name":"Create a location type","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1location~1type/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a location type","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Adds a category that locations can be filed under. Point a location at it with"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"headcount_location_type_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on the create or update endpoint for that location."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A type created without "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sort_order"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" comes back without that field"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", rather than"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"with its stored default of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Read the type back if you need its complete state."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1location~1type/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_358"}},"schemaId":"schema_358","pointer":"/paths/~1api~1v2~1headcount~1location~1type/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/headcount/location/type","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_358"}},"responseCodes":["201","404"],"pointer":"/api/v2/headcount/location/type","href":"headcount-module/createalocationtype","openApiOperationId":"createALocationType","summary":"Create a location type"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_358","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_358"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_359"}},"schemaId":"schema_359"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1headcount~1location~1type/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_359","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_359"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/headcount-module/createalocationtype"}],"panels":[]}]},"httpPath":"/api/v2/headcount/location/type"},{"label":"Read a location type","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/headcount-module/readalocationtype","routeSlug":"/api-docs/openapi/headcount-module/readalocationtype","metadata":{"seo":{"title":"Read a location type","description":"Returns one category with its name and sort position."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"readALocationType","name":"Read a location type","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1location~1type~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Read a location type","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns one category with its name and sort position."},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the location type.","required":true}],"pointer":"/paths/~1api~1v2~1headcount~1location~1type~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1location~1type~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/headcount/location/type/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/v2/headcount/location/type/{id}","href":"headcount-module/readalocationtype","openApiOperationId":"readALocationType","summary":"Read a location type"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_359"}},"schemaId":"schema_359"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1headcount~1location~1type~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_359","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_359"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/headcount-module/readalocationtype"}],"panels":[]}]},"httpPath":"/api/v2/headcount/location/type/{id}"},{"label":"Update a location type","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/headcount-module/updatealocationtype","routeSlug":"/api-docs/openapi/headcount-module/updatealocationtype","metadata":{"seo":{"title":"Update a location type","description":"Updates the fields supplied and returns the type in the same shape as reading it. Only the fields sent are touched, so an empty body is a valid request that changes nothing."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateALocationType","name":"Update a location type","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1location~1type~1{id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a location type","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Updates the fields supplied and returns the type in the same shape as reading it.\nOnly the fields sent are touched, so an empty body is a valid request that changes\nnothing.\n\nRenaming a type does not affect which locations are filed under it."},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the location type.","required":true}],"pointer":"/paths/~1api~1v2~1headcount~1location~1type~1{id}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1location~1type~1{id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_360"}},"schemaId":"schema_360","pointer":"/paths/~1api~1v2~1headcount~1location~1type~1{id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v2/headcount/location/type/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_360"}},"responseCodes":["200","404"],"pointer":"/api/v2/headcount/location/type/{id}","href":"headcount-module/updatealocationtype","openApiOperationId":"updateALocationType","summary":"Update a location type"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_360","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_360"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_359"}},"schemaId":"schema_359"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1headcount~1location~1type~1{id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_359","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_359"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/headcount-module/updatealocationtype"}],"panels":[]}]},"httpPath":"/api/v2/headcount/location/type/{id}"},{"label":"Delete a location type","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/headcount-module/deletealocationtype","routeSlug":"/api-docs/openapi/headcount-module/deletealocationtype","metadata":{"seo":{"title":"Delete a location type","description":"Removes the category. The record is retained internally so past reporting is notlost, but the type can no longer be read or edited and no endpoint restores it."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteALocationType","name":"Delete a location type","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1location~1type~1{id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete a location type","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Removes the category. The record is retained internally so past reporting is not"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"lost, but the type can no longer be read or edited and no endpoint restores it."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Locations filed under it are "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"not"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" deleted and keep pointing at the removed type,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"so reassign them first if they should stay categorised."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the location type.","required":true}],"pointer":"/paths/~1api~1v2~1headcount~1location~1type~1{id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1location~1type~1{id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/v2/headcount/location/type/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["204","404"],"pointer":"/api/v2/headcount/location/type/{id}","href":"headcount-module/deletealocationtype","openApiOperationId":"deleteALocationType","summary":"Delete a location type"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"No content, successful deletion","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1headcount~1location~1type~1{id}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"204","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/headcount-module/deletealocationtype"}],"panels":[]}]},"httpPath":"/api/v2/headcount/location/type/{id}"}],"content":{"contentType":"group","meta":{"name":"Headcount Module"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Headcount Module","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v2/headcount/functionalarea","summary":"List functional areas","prefix":{"name":"get","color":"get"},"badges":[],"link":"/headcount-module/listfunctionalareas","deprecated":false},{"title":"/api/v2/headcount/functionalarea","summary":"Create a functional area","prefix":{"name":"post","color":"post"},"badges":[],"link":"/headcount-module/createafunctionalarea","deprecated":false},{"title":"/api/v2/headcount/functionalarea/{id}","summary":"Read a functional area","prefix":{"name":"get","color":"get"},"badges":[],"link":"/headcount-module/readafunctionalarea","deprecated":false},{"title":"/api/v2/headcount/functionalarea/{id}","summary":"Update a functional area","prefix":{"name":"put","color":"put"},"badges":[],"link":"/headcount-module/updateafunctionalarea","deprecated":false},{"title":"/api/v2/headcount/functionalarea/{id}","summary":"Delete a functional area","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/headcount-module/deleteafunctionalarea","deprecated":false},{"title":"/api/v2/headcount/functionalarea/{functionalarea_id}/jobtitle","summary":"List job titles","prefix":{"name":"get","color":"get"},"badges":[],"link":"/headcount-module/listjobtitles","deprecated":false},{"title":"/api/v2/headcount/functionalarea/{functionalarea_id}/jobtitle","summary":"Create a job title","prefix":{"name":"post","color":"post"},"badges":[],"link":"/headcount-module/createajobtitle","deprecated":false},{"title":"/api/v2/headcount/functionalarea/{functionalarea_id}/jobtitle/{id}","summary":"Read a job title","prefix":{"name":"get","color":"get"},"badges":[],"link":"/headcount-module/readajobtitle","deprecated":false},{"title":"/api/v2/headcount/functionalarea/{functionalarea_id}/jobtitle/{id}","summary":"Update a job title","prefix":{"name":"put","color":"put"},"badges":[],"link":"/headcount-module/updateajobtitle","deprecated":false},{"title":"/api/v2/headcount/functionalarea/{functionalarea_id}/jobtitle/{id}","summary":"Delete a job title","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/headcount-module/deleteajobtitle","deprecated":false},{"title":"/api/v2/headcount/functionalarea/type","summary":"List functional area types","prefix":{"name":"get","color":"get"},"badges":[],"link":"/headcount-module/listfunctionalareatypes","deprecated":false},{"title":"/api/v2/headcount/functionalarea/type","summary":"Create a functional area type","prefix":{"name":"post","color":"post"},"badges":[],"link":"/headcount-module/createafunctionalareatype","deprecated":false},{"title":"/api/v2/headcount/functionalarea/type/{id}","summary":"Read a functional area type","prefix":{"name":"get","color":"get"},"badges":[],"link":"/headcount-module/readafunctionalareatype","deprecated":false},{"title":"/api/v2/headcount/functionalarea/type/{id}","summary":"Update a functional area type","prefix":{"name":"put","color":"put"},"badges":[],"link":"/headcount-module/updateafunctionalareatype","deprecated":false},{"title":"/api/v2/headcount/functionalarea/type/{id}","summary":"Delete a functional area type","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/headcount-module/deleteafunctionalareatype","deprecated":false},{"title":"/api/v2/headcount/functionalarea/{functionalarea_id}/user/mass-create","summary":"Add people to a functional area","prefix":{"name":"post","color":"post"},"badges":[],"link":"/headcount-module/addpeopletoafunctionalarea","deprecated":false},{"title":"/api/v2/headcount/location","summary":"List locations","prefix":{"name":"get","color":"get"},"badges":[],"link":"/headcount-module/listlocations","deprecated":false},{"title":"/api/v2/headcount/location","summary":"Create a location","prefix":{"name":"post","color":"post"},"badges":[],"link":"/headcount-module/createalocation","deprecated":false},{"title":"/api/v2/headcount/location/{id}","summary":"Read a location","prefix":{"name":"get","color":"get"},"badges":[],"link":"/headcount-module/readalocation","deprecated":false},{"title":"/api/v2/headcount/location/{id}","summary":"Update a location","prefix":{"name":"put","color":"put"},"badges":[],"link":"/headcount-module/updatealocation","deprecated":false},{"title":"/api/v2/headcount/location/{id}","summary":"Delete a location","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/headcount-module/deletealocation","deprecated":false},{"title":"/api/v2/headcount/location/{location_id}/venue","summary":"List a location's venues","prefix":{"name":"get","color":"get"},"badges":[],"link":"/headcount-module/listalocationsvenues","deprecated":false},{"title":"/api/v2/headcount/location/{location_id}/venue","summary":"Create a venue","prefix":{"name":"post","color":"post"},"badges":[],"link":"/headcount-module/createavenue","deprecated":false},{"title":"/api/v2/headcount/location/{location_id}/venue/{id}","summary":"Read a venue","prefix":{"name":"get","color":"get"},"badges":[],"link":"/headcount-module/readavenue","deprecated":false},{"title":"/api/v2/headcount/location/{location_id}/venue/{id}","summary":"Update a venue","prefix":{"name":"put","color":"put"},"badges":[],"link":"/headcount-module/updateavenue","deprecated":false},{"title":"/api/v2/headcount/location/{location_id}/venue/{id}","summary":"Delete a venue","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/headcount-module/deleteavenue","deprecated":false},{"title":"/api/v2/headcount/location/type","summary":"List location types","prefix":{"name":"get","color":"get"},"badges":[],"link":"/headcount-module/listlocationtypes","deprecated":false},{"title":"/api/v2/headcount/location/type","summary":"Create a location type","prefix":{"name":"post","color":"post"},"badges":[],"link":"/headcount-module/createalocationtype","deprecated":false},{"title":"/api/v2/headcount/location/type/{id}","summary":"Read a location type","prefix":{"name":"get","color":"get"},"badges":[],"link":"/headcount-module/readalocationtype","deprecated":false},{"title":"/api/v2/headcount/location/type/{id}","summary":"Update a location type","prefix":{"name":"put","color":"put"},"badges":[],"link":"/headcount-module/updatealocationtype","deprecated":false},{"title":"/api/v2/headcount/location/type/{id}","summary":"Delete a location type","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/headcount-module/deletealocationtype","deprecated":false}]}]}]}]}},{"type":"group","label":"Inventory Module","link":"/api-docs/openapi/inventory-module","routeSlug":"/api-docs/openapi/inventory-module","items":[{"label":"List inventory items","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/inventory-module/listinventoryitems","routeSlug":"/api-docs/openapi/inventory-module/listinventoryitems","metadata":{"seo":{"title":"List inventory items","description":"Returns the items in the account's catalogue - the things that can be allocated to people, such as uniforms, equipment and redeemable rewards."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listInventoryItems","name":"List inventory items","isWebhook":false,"pointer":"/paths/~1api~1v2~1inventory~1item/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List inventory items","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns the items in the account's catalogue - the things that can be allocated\nto people, such as uniforms, equipment and redeemable rewards.\n\nItems shared down from a parent account are included alongside the account's\nown. nice carries the stock figures worked out for each item: how many are\nallocated, how many have been handed over, and how many remain.\n\nThe response is only wrapped in a paginated envelope when a page parameter is\nsent. Without one, every match comes back as a flat array."},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"per_page","in":"query","schemaId":"schema_262","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of results to return per page. The higher the number the longer the request may take."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is highly recommended to use this to avoid timeouts as your data grows."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate results."},"children":[]}]}]}]},{"name":"page","in":"query","schemaId":"schema_263","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The page of results to return. Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"per_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"results. If not specified, defaults to 1."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response's next_page_url will be null if there are no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"more pages."},"children":[]}]}]}]},{"name":"filter","in":"query","schemaId":"schema_264","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A filter to apply to the results. Declared as an array of objects, where each object"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contains an attr (attribute code), operator and value key. Examples:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=name&filter[0][operator]=like&filter[0][value]=luke"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=id&filter[0][operator]=>&filter[0][value]=265"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the filters documentation for more details on how to use this."},"children":[]}]}]}],"example":null},{"name":"sort_by","in":"query","schemaId":"schema_265","description":"The field to sort the results by. No ordering is applied unless you specify one, so\nrow order is not guaranteed. Always send it when paging through a list, otherwise\nrecords can repeat or be missed between pages.\nExample: id","example":null},{"name":"sort_order","in":"query","schemaId":"schema_266","description":"The direction to sort the results by. Can be 'asc' or 'desc', default is 'asc'.","example":null},{"name":"_locale","in":"query","schemaId":"schema_267","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The locale to use for the response. This primarily affects the results of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contain human-readable labels and terms, as well as locale-specific date formats.,"},"children":[]}]}]}]},{"name":"extras","in":"query","schemaId":"schema_361","description":"A list of extras to include in the response. These are objects or arrays that are not part of\nthe model's primary attributes, such as stats and counts.\nFor fast responses, avoid requesting them if you don't need them. "}],"pointer":"/paths/~1api~1v2~1inventory~1item/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1inventory~1item/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/inventory/item","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[{"name":"per_page","in":"query","required":false,"schemaId":"schema_262"},{"name":"page","in":"query","required":false,"schemaId":"schema_263"},{"name":"filter","in":"query","required":false,"schemaId":"schema_264"},{"name":"sort_by","in":"query","required":false,"schemaId":"schema_265"},{"name":"sort_order","in":"query","required":false,"schemaId":"schema_266"},{"name":"_locale","in":"query","required":false,"schemaId":"schema_267"},{"name":"extras","in":"query","required":false,"schemaId":"schema_361"}],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/inventory/item","href":"inventory-module/listinventoryitems","openApiOperationId":"listInventoryItems","summary":"List inventory items"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_362"}},"schemaId":"schema_362"}],"pointer":"/paths/~1api~1v2~1inventory~1item/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_362","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_362"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/inventory-module/listinventoryitems"}],"panels":[]}]},"httpPath":"/api/v2/inventory/item"},{"label":"Create an inventory item","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/inventory-module/createaninventoryitem","routeSlug":"/api-docs/openapi/inventory-module/createaninventoryitem","metadata":{"seo":{"title":"Create an inventory item","description":"Adds an item to the account's catalogue and returns it."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createAnInventoryItem","name":"Create an inventory item","isWebhook":false,"pointer":"/paths/~1api~1v2~1inventory~1item/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create an inventory item","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Adds an item to the account's catalogue and returns it."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The created item comes back with only the fields that were set on it"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", not"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the full record that reading it returns - the columns left to their defaults"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"are absent rather than present and defaulted. Read the item back if you need"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"its complete state."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"name and type are required. type decides which of the other fields apply: a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"distributable"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" item is physical and tracked per person, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"virtual"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is issued"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"without stock, and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"certificate"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issues a certificate when allocated."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Four fields are gated by a companion switch"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and are rejected without it -"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"quantity needs has_quantity, ttl needs has_expiry, reward_point_cost needs"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"is_redeemable, and serial_assignment_mode needs has_serial. Sending the value"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"without the switch returns a 422 naming the field. Leaving a switch off resets"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"its field rather than storing what was sent, so quantity comes back 0, ttl"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"null, reward_point_cost 0 and serial_assignment_mode null."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"To attach an uploaded image"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", set is_image and send the request as"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"multipart/form-data"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with the image in the file_path part; the other fields go"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"in the same form. To point at an image you already host, set is_image and send"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"file_path as a URL in an ordinary JSON body. Either way the resolved image is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"stored on icon and file_path itself is not kept. Without is_image, send an icon"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"class name on icon instead."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The account's own attribute configuration also applies, so a create may accept"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"or require fields beyond those listed here."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1inventory~1item/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_363"}},"schemaId":"schema_363","pointer":"/paths/~1api~1v2~1inventory~1item/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/inventory/item","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_363"}},"responseCodes":["201","404"],"pointer":"/api/v2/inventory/item","href":"inventory-module/createaninventoryitem","openApiOperationId":"createAnInventoryItem","summary":"Create an inventory item"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_363","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_363"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_364"}},"schemaId":"schema_364"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1inventory~1item/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_364","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_364"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/inventory-module/createaninventoryitem"}],"panels":[]}]},"httpPath":"/api/v2/inventory/item"},{"label":"Read an inventory item","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/inventory-module/readaninventoryitem","routeSlug":"/api-docs/openapi/inventory-module/readaninventoryitem","metadata":{"seo":{"title":"Read an inventory item","description":"Returns one item from the catalogue, with its stock settings, how it may beobtained, and what happens when it is allocated."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"readAnInventoryItem","name":"Read an inventory item","isWebhook":false,"pointer":"/paths/~1api~1v2~1inventory~1item~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Read an inventory item","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns one item from the catalogue, with its stock settings, how it may be"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"obtained, and what happens when it is allocated."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"nice carries the worked-out stock position - allocated, distributed, available"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and a stock_level percentage - which is the useful view of how much is left,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"since quantity on its own is the figure the item was stocked with."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the inventory item.","required":true}],"pointer":"/paths/~1api~1v2~1inventory~1item~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1inventory~1item~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/inventory/item/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/v2/inventory/item/{id}","href":"inventory-module/readaninventoryitem","openApiOperationId":"readAnInventoryItem","summary":"Read an inventory item"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_365"}},"schemaId":"schema_365"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1inventory~1item~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_365","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_365"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/inventory-module/readaninventoryitem"}],"panels":[]}]},"httpPath":"/api/v2/inventory/item/{id}"},{"label":"Update an inventory item","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/inventory-module/updateaninventoryitem","routeSlug":"/api-docs/openapi/inventory-module/updateaninventoryitem","metadata":{"seo":{"title":"Update an inventory item","description":"Updates the fields supplied and returns the item in the same shape as readingit."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateAnInventoryItem","name":"Update an inventory item","isWebhook":false,"pointer":"/paths/~1api~1v2~1inventory~1item~1{id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update an inventory item","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Updates the fields supplied and returns the item in the same shape as reading"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"it."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The companion-switch pairs behave as they do on create, and that matters more"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"here because turning a switch off "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"discards the stored value"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": clearing"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"has_quantity resets quantity to 0, clearing has_expiry resets ttl to null,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"clearing is_redeemable resets reward_point_cost to 0, and clearing has_serial"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"resets serial_assignment_mode to null. Sending one of those values while its"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"switch is off returns a 422 naming the field."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Changing stock settings does not touch items already allocated to people. An"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"allocation keeps the expiry it was given, so shortening the item's validity"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"period changes only what future allocations get."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Images work as they do on create - see the create endpoint for how to send a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"file rather than a URL."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The account's own attribute configuration also applies, so an update may accept"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"fields beyond those listed here."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the inventory item.","required":true}],"pointer":"/paths/~1api~1v2~1inventory~1item~1{id}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1inventory~1item~1{id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_366"}},"schemaId":"schema_366","pointer":"/paths/~1api~1v2~1inventory~1item~1{id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v2/inventory/item/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_366"}},"responseCodes":["200","404"],"pointer":"/api/v2/inventory/item/{id}","href":"inventory-module/updateaninventoryitem","openApiOperationId":"updateAnInventoryItem","summary":"Update an inventory item"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_366","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_366"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_365"}},"schemaId":"schema_365"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1inventory~1item~1{id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_365","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_365"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/inventory-module/updateaninventoryitem"}],"panels":[]}]},"httpPath":"/api/v2/inventory/item/{id}"},{"label":"Delete an inventory item","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/inventory-module/deleteaninventoryitem","routeSlug":"/api-docs/openapi/inventory-module/deleteaninventoryitem","metadata":{"seo":{"title":"Delete an inventory item","description":"Removes the item from the catalogue. The record is retained internally, so existing allocations and past reporting are not lost, but the item can no longer be allocated and no endpoint restores it."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteAnInventoryItem","name":"Delete an inventory item","isWebhook":false,"pointer":"/paths/~1api~1v2~1inventory~1item~1{id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete an inventory item","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Removes the item from the catalogue. The record is retained internally, so\nexisting allocations and past reporting are not lost, but the item can no\nlonger be allocated and no endpoint restores it."},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the inventory item.","required":true}],"pointer":"/paths/~1api~1v2~1inventory~1item~1{id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1inventory~1item~1{id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/v2/inventory/item/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["204","404"],"pointer":"/api/v2/inventory/item/{id}","href":"inventory-module/deleteaninventoryitem","openApiOperationId":"deleteAnInventoryItem","summary":"Delete an inventory item"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"No content, successful deletion","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1inventory~1item~1{id}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"204","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/inventory-module/deleteaninventoryitem"}],"panels":[]}]},"httpPath":"/api/v2/inventory/item/{id}"},{"label":"Allocate an item to a person","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/inventory-module/allocateanitemtoaperson","routeSlug":"/api-docs/openapi/inventory-module/allocateanitemtoaperson","metadata":{"seo":{"title":"Allocate an item to a person","description":"Gives one unit of the item in the URL to one person and returns the allocation."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"allocateAnItemToAPerson","name":"Allocate an item to a person","isWebhook":false,"pointer":"/paths/~1api~1v2~1inventory~1item~1{item_id}~1user/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Allocate an item to a person","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Gives one unit of the item in the URL to one person and returns the allocation."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"One record is one unit."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" quantity is accepted but not stored, so send the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"request again to give someone several."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the item limits how many one person may hold, an allocation that would"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"exceed the limit is "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"rejected"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and reports the limit. Send"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ignore_max_per_user to allocate anyway."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For an item with serials, the serial is taken care of according to how the item"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"is set up - assigned automatically from the free pool, or expected to be named"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"when the item is handed over. An item with no free serials left cannot be"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"allocated."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Leave collected_at unset for an allocation that has not been handed over yet;"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"that is what the collect endpoint acts on. Leave expires_at unset to take the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"expiry from the item's validity period."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The allocation comes back with the person and the item embedded, so a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"follow-up read is not needed."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"item_id","in":"path","schemaId":"schema_317","description":"The ID of the inventory item.","required":true}],"pointer":"/paths/~1api~1v2~1inventory~1item~1{item_id}~1user/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1inventory~1item~1{item_id}~1user/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_367"}},"schemaId":"schema_367","pointer":"/paths/~1api~1v2~1inventory~1item~1{item_id}~1user/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/inventory/item/{item_id}/user","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"item_id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_367"}},"responseCodes":["201","404"],"pointer":"/api/v2/inventory/item/{item_id}/user","href":"inventory-module/allocateanitemtoaperson","openApiOperationId":"allocateAnItemToAPerson","summary":"Allocate an item to a person"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_367","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_367"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_368"}},"schemaId":"schema_368"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1inventory~1item~1{item_id}~1user/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_368","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_368"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/inventory-module/allocateanitemtoaperson"}],"panels":[]}]},"httpPath":"/api/v2/inventory/item/{item_id}/user"},{"label":"Read an allocation","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/inventory-module/readanallocation","routeSlug":"/api-docs/openapi/inventory-module/readanallocation","metadata":{"seo":{"title":"Read an allocation","description":"Returns one allocation of an item to a person: when it was given, when it was collected, when it expires, and which serial was assigned if the item carries them."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"readAnAllocation","name":"Read an allocation","isWebhook":false,"pointer":"/paths/~1api~1v2~1inventory~1item~1{item_id}~1user~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Read an allocation","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns one allocation of an item to a person: when it was given, when it was\ncollected, when it expires, and which serial was assigned if the item carries\nthem.\n\nThe person and the item are embedded in the response by default rather than\nhaving to be asked for. The person is returned as their full profile, so treat\nthis response as carrying personal data even when all you wanted was the\nallocation.\n\nAn allocation with no collection time has not been handed over yet.\n\nThe allocation must belong to the item in the URL; a mismatched pair returns a\n404."},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"item_id","in":"path","schemaId":"schema_317","description":"The ID of the inventory item.","required":true},{"name":"id","in":"path","schemaId":"schema_369","description":"The ID of the allocation.","required":true}],"pointer":"/paths/~1api~1v2~1inventory~1item~1{item_id}~1user~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1inventory~1item~1{item_id}~1user~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/inventory/item/{item_id}/user/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"item_id","in":"path","required":true,"schemaId":"schema_317"},{"name":"id","in":"path","required":true,"schemaId":"schema_369"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/v2/inventory/item/{item_id}/user/{id}","href":"inventory-module/readanallocation","openApiOperationId":"readAnAllocation","summary":"Read an allocation"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_368"}},"schemaId":"schema_368"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1inventory~1item~1{item_id}~1user~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_368","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_368"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/inventory-module/readanallocation"}],"panels":[]}]},"httpPath":"/api/v2/inventory/item/{item_id}/user/{id}"},{"label":"Update an allocation","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/inventory-module/updateanallocation","routeSlug":"/api-docs/openapi/inventory-module/updateanallocation","metadata":{"seo":{"title":"Update an allocation","description":"Updates the fields supplied and leaves the rest untouched, then returns theallocation in the same shape as reading it. Every field is optional."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateAnAllocation","name":"Update an allocation","isWebhook":false,"pointer":"/paths/~1api~1v2~1inventory~1item~1{item_id}~1user~1{id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update an allocation","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Updates the fields supplied and leaves the rest untouched, then returns the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"allocation in the same shape as reading it. Every field is optional."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Setting collected_at is how an allocation is marked as handed over one at a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"time; the collect endpoint does the same thing for many at once and also"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"records who collected it."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sending user_id moves the allocation to a different person. The item's"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"per-person limit is "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"not"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rechecked when it does, so an update can leave"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"someone holding more than the item permits."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"quantity is accepted and discarded here as it is on create."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The allocation must belong to the item in the URL; a mismatched pair returns a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"404."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"item_id","in":"path","schemaId":"schema_317","description":"The ID of the inventory item.","required":true},{"name":"id","in":"path","schemaId":"schema_369","description":"The ID of the allocation.","required":true}],"pointer":"/paths/~1api~1v2~1inventory~1item~1{item_id}~1user~1{id}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1inventory~1item~1{item_id}~1user~1{id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_370"}},"schemaId":"schema_370","pointer":"/paths/~1api~1v2~1inventory~1item~1{item_id}~1user~1{id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v2/inventory/item/{item_id}/user/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"item_id","in":"path","required":true,"schemaId":"schema_317"},{"name":"id","in":"path","required":true,"schemaId":"schema_369"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_370"}},"responseCodes":["200","404"],"pointer":"/api/v2/inventory/item/{item_id}/user/{id}","href":"inventory-module/updateanallocation","openApiOperationId":"updateAnAllocation","summary":"Update an allocation"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_370","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_370"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_368"}},"schemaId":"schema_368"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1inventory~1item~1{item_id}~1user~1{id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_368","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_368"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/inventory-module/updateanallocation"}],"panels":[]}]},"httpPath":"/api/v2/inventory/item/{item_id}/user/{id}"},{"label":"Delete an allocation","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/inventory-module/deleteanallocation","routeSlug":"/api-docs/openapi/inventory-module/deleteanallocation","metadata":{"seo":{"title":"Delete an allocation","description":"Takes the item back from the person. The record is retained internally so past reporting is not lost, and no endpoint restores it."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteAnAllocation","name":"Delete an allocation","isWebhook":false,"pointer":"/paths/~1api~1v2~1inventory~1item~1{item_id}~1user~1{id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete an allocation","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Takes the item back from the person. The record is retained internally so past\nreporting is not lost, and no endpoint restores it.\n\nDeleting an allocation frees the person to be allocated the item again, and\nreturns any serial it held to the free pool.\n\nThe allocation must belong to the item in the URL; a mismatched pair returns a\n404."},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"item_id","in":"path","schemaId":"schema_317","description":"The ID of the inventory item.","required":true},{"name":"id","in":"path","schemaId":"schema_369","description":"The ID of the allocation.","required":true}],"pointer":"/paths/~1api~1v2~1inventory~1item~1{item_id}~1user~1{id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1inventory~1item~1{item_id}~1user~1{id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/v2/inventory/item/{item_id}/user/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"item_id","in":"path","required":true,"schemaId":"schema_317"},{"name":"id","in":"path","required":true,"schemaId":"schema_369"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["204","404"],"pointer":"/api/v2/inventory/item/{item_id}/user/{id}","href":"inventory-module/deleteanallocation","openApiOperationId":"deleteAnAllocation","summary":"Delete an allocation"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"No content, successful deletion","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1inventory~1item~1{item_id}~1user~1{id}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"204","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/inventory-module/deleteanallocation"}],"panels":[]}]},"httpPath":"/api/v2/inventory/item/{item_id}/user/{id}"},{"label":"Allocate an item to many people","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/inventory-module/allocateanitemtomanypeople","routeSlug":"/api-docs/openapi/inventory-module/allocateanitemtomanypeople","metadata":{"seo":{"title":"Allocate an item to many people","description":"Allocates one item to a set of people in a single call. The work is queuedrather than done while you wait, so a 200 means the request was accepted, notthat anyone has been allocated anything yet."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"allocateAnItemToManyPeople","name":"Allocate an item to many people","isWebhook":false,"pointer":"/paths/~1api~1v2~1inventory~1item~1user~1mass-add-item-to-users/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Allocate an item to many people","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Allocates one item to a set of people in a single call. The work is queued"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"rather than done while you wait, so a 200 means the request was accepted, not"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"that anyone has been allocated anything yet."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The token in the response cannot be looked up."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" There is no endpoint that"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"resolves it and no completion callback, so confirm the outcome by listing the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"item's allocations rather than by polling. Nothing is reported back if some"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"people could not be allocated - a person already holding as many as the item"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"permits, or an item that runs out of stock or serials part way through, is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"skipped and the run continues."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Choose who to allocate to with applyTo: send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" together with the list"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"of person IDs, or any other value to allocate to everyone the caller can see,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"narrowed by filter."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"quantity is how many of the item each person gets, and it is honoured here -"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the item is allocated that many times per person."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note applyTo is camelCase, unlike every other field on this endpoint."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1inventory~1item~1user~1mass-add-item-to-users/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_371"}},"schemaId":"schema_371","pointer":"/paths/~1api~1v2~1inventory~1item~1user~1mass-add-item-to-users/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/inventory/item/user/mass-add-item-to-users","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_371"}},"responseCodes":["200"],"pointer":"/api/v2/inventory/item/user/mass-add-item-to-users","href":"inventory-module/allocateanitemtomanypeople","openApiOperationId":"allocateAnItemToManyPeople","summary":"Allocate an item to many people"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_371","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_371"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_284"}},"schemaId":"schema_284"}],"pointer":"/paths/~1api~1v2~1inventory~1item~1user~1mass-add-item-to-users/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_284","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_284"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/inventory-module/allocateanitemtomanypeople"}],"panels":[]}]},"httpPath":"/api/v2/inventory/item/user/mass-add-item-to-users"},{"label":"Mark allocations as collected","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/inventory-module/markallocationsascollected","routeSlug":"/api-docs/openapi/inventory-module/markallocationsascollected","metadata":{"seo":{"title":"Mark allocations as collected","description":"Records that items already allocated to people have now been handed over,several at once. This is the counterpart to setting collected_at on a singleallocation, and it also records who handed the item over."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"markAllocationsAsCollected","name":"Mark allocations as collected","isWebhook":false,"pointer":"/paths/~1api~1v2~1inventory~1item~1user~1collect/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Mark allocations as collected","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Records that items already allocated to people have now been handed over,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"several at once. This is the counterpart to setting collected_at on a single"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"allocation, and it also records who handed the item over."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Each entry in items names the allocation to collect. Entries are matched only"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"against allocations held by one of the people in user_ids and only against"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"allocations not already collected, so calling this twice with the same body"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"does not double-record anything."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Every entry is checked before anything is recorded"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - an unknown allocation,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"one belonging to an unpublished item, or a missing or unusable serial where the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"item needs one, rejects the whole request with a 422 and nothing is collected."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An entry that passes validation but matches no uncollected allocation is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"skipped silently, so a success does not by itself mean every entry took effect."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response carries no body; read the allocations back to confirm."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1inventory~1item~1user~1collect/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_372"}},"schemaId":"schema_372","pointer":"/paths/~1api~1v2~1inventory~1item~1user~1collect/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/inventory/item/user/collect","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_372"}},"responseCodes":["200"],"pointer":"/api/v2/inventory/item/user/collect","href":"inventory-module/markallocationsascollected","openApiOperationId":"markAllocationsAsCollected","summary":"Mark allocations as collected"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_372","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_372"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_311"}},"schemaId":"schema_311"}],"pointer":"/paths/~1api~1v2~1inventory~1item~1user~1collect/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_311","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_311"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/inventory-module/markallocationsascollected"}],"panels":[]}]},"httpPath":"/api/v2/inventory/item/user/collect"},{"label":"Create an allocation rule","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/inventory-module/createanallocationrule","routeSlug":"/api-docs/openapi/inventory-module/createanallocationrule","metadata":{"seo":{"title":"Create an allocation rule","description":"Sets up a rule that hands items out on its own: it names a thing to measure -shifts worked, events attended, hours attended - and a threshold, and everyonewho reaches that threshold is given the items attached to the rule. Attach thoseitems with the create endpoint on the rule's own item list; a rule with no itemsis valid and does nothing."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createAnAllocationRule","name":"Create an allocation rule","isWebhook":false,"pointer":"/paths/~1api~1v2~1inventory~1allocation/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create an allocation rule","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sets up a rule that hands items out on its own: it names a thing to measure -"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"shifts worked, events attended, hours attended - and a threshold, and everyone"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"who reaches that threshold is given the items attached to the rule. Attach those"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"items with the create endpoint on the rule's own item list; a rule with no items"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"is valid and does nothing."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The rule is applied as people work, not retrospectively, so it takes effect from"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the moment it is created rather than granting items to anyone who already meets"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the threshold."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The created rule comes back with only the fields that were set on it"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", not"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the full record that reading it returns, and without the item list. Read the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"rule back if you need its complete state."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1inventory~1allocation/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_373"}},"schemaId":"schema_373","pointer":"/paths/~1api~1v2~1inventory~1allocation/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/inventory/allocation","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_373"}},"responseCodes":["201","404"],"pointer":"/api/v2/inventory/allocation","href":"inventory-module/createanallocationrule","openApiOperationId":"createAnAllocationRule","summary":"Create an allocation rule"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_373","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_373"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_374"}},"schemaId":"schema_374"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1inventory~1allocation/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_374","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_374"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/inventory-module/createanallocationrule"}],"panels":[]}]},"httpPath":"/api/v2/inventory/allocation"},{"label":"Read an allocation rule","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/inventory-module/readanallocationrule","routeSlug":"/api-docs/openapi/inventory-module/readanallocationrule","metadata":{"seo":{"title":"Read an allocation rule","description":"Returns one rule with its qualifying condition and the items it hands out."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"readAnAllocationRule","name":"Read an allocation rule","isWebhook":false,"pointer":"/paths/~1api~1v2~1inventory~1allocation~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Read an allocation rule","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns one rule with its qualifying condition and the items it hands out."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"relations.items"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" carries the item list in full, so a separate call is not"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"needed to see what the rule gives away. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" restates the qualifying condition"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"in readable form - "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rule_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the measure and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rule_value"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" the threshold."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the allocation rule.","required":true}],"pointer":"/paths/~1api~1v2~1inventory~1allocation~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1inventory~1allocation~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/inventory/allocation/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/v2/inventory/allocation/{id}","href":"inventory-module/readanallocationrule","openApiOperationId":"readAnAllocationRule","summary":"Read an allocation rule"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_375"}},"schemaId":"schema_375"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1inventory~1allocation~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_375","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_375"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/inventory-module/readanallocationrule"}],"panels":[]}]},"httpPath":"/api/v2/inventory/allocation/{id}"},{"label":"Update an allocation rule","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/inventory-module/updateanallocationrule","routeSlug":"/api-docs/openapi/inventory-module/updateanallocationrule","metadata":{"seo":{"title":"Update an allocation rule","description":"Updates the fields supplied and returns the rule in the same shape as readingit. Only the fields sent are touched, so an empty body is a valid request thatchanges nothing, and omitting rules leaves the qualifying condition alonerather than clearing it."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateAnAllocationRule","name":"Update an allocation rule","isWebhook":false,"pointer":"/paths/~1api~1v2~1inventory~1allocation~1{id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update an allocation rule","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Updates the fields supplied and returns the rule in the same shape as reading"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"it. Only the fields sent are touched, so an empty body is a valid request that"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"changes nothing, and omitting "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rules"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" leaves the qualifying condition alone"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"rather than clearing it."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Changing the threshold does not revisit anyone who already qualified - items"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"already handed out stay handed out, and raising the threshold does not take them"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"back. The new condition applies from here on."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the allocation rule.","required":true}],"pointer":"/paths/~1api~1v2~1inventory~1allocation~1{id}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1inventory~1allocation~1{id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_376"}},"schemaId":"schema_376","pointer":"/paths/~1api~1v2~1inventory~1allocation~1{id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v2/inventory/allocation/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_376"}},"responseCodes":["200","404"],"pointer":"/api/v2/inventory/allocation/{id}","href":"inventory-module/updateanallocationrule","openApiOperationId":"updateAnAllocationRule","summary":"Update an allocation rule"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_376","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_376"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_375"}},"schemaId":"schema_375"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1inventory~1allocation~1{id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_375","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_375"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/inventory-module/updateanallocationrule"}],"panels":[]}]},"httpPath":"/api/v2/inventory/allocation/{id}"},{"label":"Delete an allocation rule","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/inventory-module/deleteanallocationrule","routeSlug":"/api-docs/openapi/inventory-module/deleteanallocationrule","metadata":{"seo":{"title":"Delete an allocation rule","description":"Stops the rule handing anything else out. The record is retained internally so past reporting is not lost, but the rule can no longer be read or edited and no endpoint restores it."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteAnAllocationRule","name":"Delete an allocation rule","isWebhook":false,"pointer":"/paths/~1api~1v2~1inventory~1allocation~1{id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete an allocation rule","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Stops the rule handing anything else out. The record is retained internally so\npast reporting is not lost, but the rule can no longer be read or edited and no\nendpoint restores it.\n\nItems already given to people under this rule are not affected - they stay with\nwhoever holds them. The rule's own item list is left behind rather than removed,\nand becomes unreachable once the rule is gone, so remove any lines you still\nneed first."},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the allocation rule.","required":true}],"pointer":"/paths/~1api~1v2~1inventory~1allocation~1{id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1inventory~1allocation~1{id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/v2/inventory/allocation/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["204","404"],"pointer":"/api/v2/inventory/allocation/{id}","href":"inventory-module/deleteanallocationrule","openApiOperationId":"deleteAnAllocationRule","summary":"Delete an allocation rule"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"No content, successful deletion","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1inventory~1allocation~1{id}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"204","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/inventory-module/deleteanallocationrule"}],"panels":[]}]},"httpPath":"/api/v2/inventory/allocation/{id}"},{"label":"Add an item to an allocation rule","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/inventory-module/addanitemtoanallocationrule","routeSlug":"/api-docs/openapi/inventory-module/addanitemtoanallocationrule","metadata":{"seo":{"title":"Add an item to an allocation rule","description":"Adds a catalogue item to the list a rule hands out, so that everyone who meetsthe rule's condition receives it. A rule can hand out several different items;add each one separately."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"addAnItemToAnAllocationRule","name":"Add an item to an allocation rule","isWebhook":false,"pointer":"/paths/~1api~1v2~1inventory~1allocation~1{allocation_id}~1item/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Add an item to an allocation rule","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Adds a catalogue item to the list a rule hands out, so that everyone who meets"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the rule's condition receives it. A rule can hand out several different items;"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"add each one separately."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Adding an item does not give it to anyone who already qualified - the list is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"read each time the rule runs, so it applies from here on."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the rule does run, an item is quietly skipped for that person if there is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"not enough of it left or if giving it would take them over the limit the item"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"sets per person. The rest of the list is still handed out, so check what people"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"actually hold rather than assuming everything on the list was given."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The created line comes back with only the fields that were set on it"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", so"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"valid_duration"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is absent rather than null when it was not sent."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"allocation_id","in":"path","schemaId":"schema_317","description":"The ID of the allocation rule.","required":true}],"pointer":"/paths/~1api~1v2~1inventory~1allocation~1{allocation_id}~1item/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1inventory~1allocation~1{allocation_id}~1item/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_377"}},"schemaId":"schema_377","pointer":"/paths/~1api~1v2~1inventory~1allocation~1{allocation_id}~1item/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/inventory/allocation/{allocation_id}/item","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"allocation_id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_377"}},"responseCodes":["201","404"],"pointer":"/api/v2/inventory/allocation/{allocation_id}/item","href":"inventory-module/addanitemtoanallocationrule","openApiOperationId":"addAnItemToAnAllocationRule","summary":"Add an item to an allocation rule"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_377","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_377"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_378"}},"schemaId":"schema_378"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1inventory~1allocation~1{allocation_id}~1item/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_378","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_378"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/inventory-module/addanitemtoanallocationrule"}],"panels":[]}]},"httpPath":"/api/v2/inventory/allocation/{allocation_id}/item"},{"label":"Read an item on an allocation rule","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/inventory-module/readanitemonanallocationrule","routeSlug":"/api-docs/openapi/inventory-module/readanitemonanallocationrule","metadata":{"seo":{"title":"Read an item on an allocation rule","description":"Returns one line from a rule's item list: which catalogue item it gives out, how many, and how long the allocation stays valid."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"readAnItemOnAnAllocationRule","name":"Read an item on an allocation rule","isWebhook":false,"pointer":"/paths/~1api~1v2~1inventory~1allocation~1{allocation_id}~1item~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Read an item on an allocation rule","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns one line from a rule's item list: which catalogue item it gives out, how\nmany, and how long the allocation stays valid.\n\nThe line has to belong to the rule named in the URL; asking for one under the\nwrong rule is not found."},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"allocation_id","in":"path","schemaId":"schema_317","description":"The ID of the allocation rule.","required":true},{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the item line on that rule.","required":true}],"pointer":"/paths/~1api~1v2~1inventory~1allocation~1{allocation_id}~1item~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1inventory~1allocation~1{allocation_id}~1item~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/inventory/allocation/{allocation_id}/item/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"allocation_id","in":"path","required":true,"schemaId":"schema_317"},{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/v2/inventory/allocation/{allocation_id}/item/{id}","href":"inventory-module/readanitemonanallocationrule","openApiOperationId":"readAnItemOnAnAllocationRule","summary":"Read an item on an allocation rule"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_378"}},"schemaId":"schema_378"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1inventory~1allocation~1{allocation_id}~1item~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_378","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_378"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/inventory-module/readanitemonanallocationrule"}],"panels":[]}]},"httpPath":"/api/v2/inventory/allocation/{allocation_id}/item/{id}"},{"label":"Update an item on an allocation rule","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/inventory-module/updateanitemonanallocationrule","routeSlug":"/api-docs/openapi/inventory-module/updateanitemonanallocationrule","metadata":{"seo":{"title":"Update an item on an allocation rule","description":"Updates the fields supplied and returns the line in the same shape as readingit. Only the fields sent are touched."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateAnItemOnAnAllocationRule","name":"Update an item on an allocation rule","isWebhook":false,"pointer":"/paths/~1api~1v2~1inventory~1allocation~1{allocation_id}~1item~1{id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update an item on an allocation rule","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Updates the fields supplied and returns the line in the same shape as reading"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"it. Only the fields sent are touched."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Changes apply to allocations made from here on. Anything already handed out"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"keeps the validity period it was given, so shortening "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"valid_duration"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" does not"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"bring forward an expiry that has already been set."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The line has to belong to the rule named in the URL; updating one under the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"wrong rule is not found and nothing is written."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"allocation_id","in":"path","schemaId":"schema_317","description":"The ID of the allocation rule.","required":true},{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the item line on that rule.","required":true}],"pointer":"/paths/~1api~1v2~1inventory~1allocation~1{allocation_id}~1item~1{id}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1inventory~1allocation~1{allocation_id}~1item~1{id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_379"}},"schemaId":"schema_379","pointer":"/paths/~1api~1v2~1inventory~1allocation~1{allocation_id}~1item~1{id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v2/inventory/allocation/{allocation_id}/item/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"allocation_id","in":"path","required":true,"schemaId":"schema_317"},{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_379"}},"responseCodes":["200","404"],"pointer":"/api/v2/inventory/allocation/{allocation_id}/item/{id}","href":"inventory-module/updateanitemonanallocationrule","openApiOperationId":"updateAnItemOnAnAllocationRule","summary":"Update an item on an allocation rule"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_379","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_379"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_378"}},"schemaId":"schema_378"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1inventory~1allocation~1{allocation_id}~1item~1{id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_378","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_378"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/inventory-module/updateanitemonanallocationrule"}],"panels":[]}]},"httpPath":"/api/v2/inventory/allocation/{allocation_id}/item/{id}"},{"label":"Remove an item from an allocation rule","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/inventory-module/removeanitemfromanallocationrule","routeSlug":"/api-docs/openapi/inventory-module/removeanitemfromanallocationrule","metadata":{"seo":{"title":"Remove an item from an allocation rule","description":"Takes the item off the rule's list so it is no longer handed out. This ispermanent - the line is removed outright rather than retained, and no endpointrestores it."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"removeAnItemFromAnAllocationRule","name":"Remove an item from an allocation rule","isWebhook":false,"pointer":"/paths/~1api~1v2~1inventory~1allocation~1{allocation_id}~1item~1{id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Remove an item from an allocation rule","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Takes the item off the rule's list so it is no longer handed out. "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"permanent"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - the line is removed outright rather than retained, and no endpoint"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"restores it."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Items already given to people under this rule are not affected; they stay with"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"whoever holds them."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The line has to belong to the rule named in the URL; deleting one under the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"wrong rule is not found and nothing is removed."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"allocation_id","in":"path","schemaId":"schema_317","description":"The ID of the allocation rule.","required":true},{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the item line on that rule.","required":true}],"pointer":"/paths/~1api~1v2~1inventory~1allocation~1{allocation_id}~1item~1{id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1inventory~1allocation~1{allocation_id}~1item~1{id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/v2/inventory/allocation/{allocation_id}/item/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"allocation_id","in":"path","required":true,"schemaId":"schema_317"},{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["204","404"],"pointer":"/api/v2/inventory/allocation/{allocation_id}/item/{id}","href":"inventory-module/removeanitemfromanallocationrule","openApiOperationId":"removeAnItemFromAnAllocationRule","summary":"Remove an item from an allocation rule"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"No content, successful deletion","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1inventory~1allocation~1{allocation_id}~1item~1{id}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"204","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/inventory-module/removeanitemfromanallocationrule"}],"panels":[]}]},"httpPath":"/api/v2/inventory/allocation/{allocation_id}/item/{id}"}],"content":{"contentType":"group","meta":{"name":"Inventory Module"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Inventory Module","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v2/inventory/item","summary":"List inventory items","prefix":{"name":"get","color":"get"},"badges":[],"link":"/inventory-module/listinventoryitems","deprecated":false},{"title":"/api/v2/inventory/item","summary":"Create an inventory item","prefix":{"name":"post","color":"post"},"badges":[],"link":"/inventory-module/createaninventoryitem","deprecated":false},{"title":"/api/v2/inventory/item/{id}","summary":"Read an inventory item","prefix":{"name":"get","color":"get"},"badges":[],"link":"/inventory-module/readaninventoryitem","deprecated":false},{"title":"/api/v2/inventory/item/{id}","summary":"Update an inventory item","prefix":{"name":"put","color":"put"},"badges":[],"link":"/inventory-module/updateaninventoryitem","deprecated":false},{"title":"/api/v2/inventory/item/{id}","summary":"Delete an inventory item","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/inventory-module/deleteaninventoryitem","deprecated":false},{"title":"/api/v2/inventory/item/{item_id}/user","summary":"Allocate an item to a person","prefix":{"name":"post","color":"post"},"badges":[],"link":"/inventory-module/allocateanitemtoaperson","deprecated":false},{"title":"/api/v2/inventory/item/{item_id}/user/{id}","summary":"Read an allocation","prefix":{"name":"get","color":"get"},"badges":[],"link":"/inventory-module/readanallocation","deprecated":false},{"title":"/api/v2/inventory/item/{item_id}/user/{id}","summary":"Update an allocation","prefix":{"name":"put","color":"put"},"badges":[],"link":"/inventory-module/updateanallocation","deprecated":false},{"title":"/api/v2/inventory/item/{item_id}/user/{id}","summary":"Delete an allocation","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/inventory-module/deleteanallocation","deprecated":false},{"title":"/api/v2/inventory/item/user/mass-add-item-to-users","summary":"Allocate an item to many people","prefix":{"name":"post","color":"post"},"badges":[],"link":"/inventory-module/allocateanitemtomanypeople","deprecated":false},{"title":"/api/v2/inventory/item/user/collect","summary":"Mark allocations as collected","prefix":{"name":"post","color":"post"},"badges":[],"link":"/inventory-module/markallocationsascollected","deprecated":false},{"title":"/api/v2/inventory/allocation","summary":"Create an allocation rule","prefix":{"name":"post","color":"post"},"badges":[],"link":"/inventory-module/createanallocationrule","deprecated":false},{"title":"/api/v2/inventory/allocation/{id}","summary":"Read an allocation rule","prefix":{"name":"get","color":"get"},"badges":[],"link":"/inventory-module/readanallocationrule","deprecated":false},{"title":"/api/v2/inventory/allocation/{id}","summary":"Update an allocation rule","prefix":{"name":"put","color":"put"},"badges":[],"link":"/inventory-module/updateanallocationrule","deprecated":false},{"title":"/api/v2/inventory/allocation/{id}","summary":"Delete an allocation rule","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/inventory-module/deleteanallocationrule","deprecated":false},{"title":"/api/v2/inventory/allocation/{allocation_id}/item","summary":"Add an item to an allocation rule","prefix":{"name":"post","color":"post"},"badges":[],"link":"/inventory-module/addanitemtoanallocationrule","deprecated":false},{"title":"/api/v2/inventory/allocation/{allocation_id}/item/{id}","summary":"Read an item on an allocation rule","prefix":{"name":"get","color":"get"},"badges":[],"link":"/inventory-module/readanitemonanallocationrule","deprecated":false},{"title":"/api/v2/inventory/allocation/{allocation_id}/item/{id}","summary":"Update an item on an allocation rule","prefix":{"name":"put","color":"put"},"badges":[],"link":"/inventory-module/updateanitemonanallocationrule","deprecated":false},{"title":"/api/v2/inventory/allocation/{allocation_id}/item/{id}","summary":"Remove an item from an allocation rule","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/inventory-module/removeanitemfromanallocationrule","deprecated":false}]}]}]}]}},{"type":"group","label":"Report Module","link":"/api-docs/openapi/report-module","routeSlug":"/api-docs/openapi/report-module","items":[{"label":"List reports","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/report-module/listreports","routeSlug":"/api-docs/openapi/report-module/listreports","metadata":{"seo":{"title":"List reports","description":"Returns a paginated list of the current account's reports. A report whose owner has been deleted is omitted from this listing."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listReports","name":"List reports","isWebhook":false,"pointer":"/paths/~1api~1v2~1report/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List reports","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns a paginated list of the current account's reports. A report whose owner\nhas been deleted is omitted from this listing."},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"per_page","in":"query","schemaId":"schema_262","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of results to return per page. The higher the number the longer the request may take."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is highly recommended to use this to avoid timeouts as your data grows."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate results."},"children":[]}]}]}]},{"name":"page","in":"query","schemaId":"schema_263","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The page of results to return. Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"per_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"results. If not specified, defaults to 1."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response's next_page_url will be null if there are no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"more pages."},"children":[]}]}]}]},{"name":"filter","in":"query","schemaId":"schema_264","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A filter to apply to the results. Declared as an array of objects, where each object"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contains an attr (attribute code), operator and value key. Examples:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=name&filter[0][operator]=like&filter[0][value]=luke"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=id&filter[0][operator]=>&filter[0][value]=265"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the filters documentation for more details on how to use this."},"children":[]}]}]}],"example":null},{"name":"sort_by","in":"query","schemaId":"schema_265","description":"The field to sort the results by. No ordering is applied unless you specify one, so\nrow order is not guaranteed. Always send it when paging through a list, otherwise\nrecords can repeat or be missed between pages.\nExample: id","example":null},{"name":"sort_order","in":"query","schemaId":"schema_266","description":"The direction to sort the results by. Can be 'asc' or 'desc', default is 'asc'.","example":null},{"name":"_locale","in":"query","schemaId":"schema_267","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The locale to use for the response. This primarily affects the results of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contain human-readable labels and terms, as well as locale-specific date formats.,"},"children":[]}]}]}]}],"pointer":"/paths/~1api~1v2~1report/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1report/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/report","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[{"name":"per_page","in":"query","required":false,"schemaId":"schema_262"},{"name":"page","in":"query","required":false,"schemaId":"schema_263"},{"name":"filter","in":"query","required":false,"schemaId":"schema_264"},{"name":"sort_by","in":"query","required":false,"schemaId":"schema_265"},{"name":"sort_order","in":"query","required":false,"schemaId":"schema_266"},{"name":"_locale","in":"query","required":false,"schemaId":"schema_267"}],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/report","href":"report-module/listreports","openApiOperationId":"listReports","summary":"List reports"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_380"}},"schemaId":"schema_380"}],"pointer":"/paths/~1api~1v2~1report/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_380","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_380"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/report-module/listreports"}],"panels":[]}]},"httpPath":"/api/v2/report"},{"label":"Create a report","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/report-module/createareport","routeSlug":"/api-docs/openapi/report-module/createareport","metadata":{"seo":{"title":"Create a report","description":"Creates a report definition and, unless it is scheduled, immediately queues itfor generation - so a 201 means the report exists, not that the file is ready.Poll the report until status becomes completed, then use the download endpoint.A scheduled report is stored with status scheduled and is not run now."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createAReport","name":"Create a report","isWebhook":false,"pointer":"/paths/~1api~1v2~1report/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a report","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Creates a report definition and, unless it is scheduled, immediately queues it"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"for generation - so a 201 means the report exists, not that the file is ready."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Poll the report until status becomes completed, then use the download endpoint."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A scheduled report is stored with status scheduled and is not run now."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"account_id and user_id are taken from the caller and cannot be set from the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"request; a value sent for either is overwritten. The response is the same shape"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"as reading the report, so a follow-up read is not needed."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Invalid input returns a 422 identifying the fields at fault. Some report types"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"require more than the fields below - the inventory bundle type also requires"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"meta.bundle_template_id, for instance."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sending _options.save_as_template also saves the report's type, category,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"filters, columns, sorting, media, sub-account and file-type settings as a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"reusable report template. It requires the report:template:create permission and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"is silently skipped without it."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1report/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_381"}},"schemaId":"schema_381","pointer":"/paths/~1api~1v2~1report/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/report","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_381"}},"responseCodes":["201","404"],"pointer":"/api/v2/report","href":"report-module/createareport","openApiOperationId":"createAReport","summary":"Create a report"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_381","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_381"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_382"}},"schemaId":"schema_382"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1report/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_382","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_382"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/report-module/createareport"}],"panels":[]}]},"httpPath":"/api/v2/report"},{"label":"Read a report","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/report-module/readareport","routeSlug":"/api-docs/openapi/report-module/readareport","metadata":{"seo":{"title":"Read a report","description":"Returns a single report's definition and current generation state. status movesthrough queued, processing and then completed or failed, and last_generated_atand file_path are only populated once a run has finished - use the downloadendpoint to obtain a link rather than reading file_path directly."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"readAReport","name":"Read a report","isWebhook":false,"pointer":"/paths/~1api~1v2~1report~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Read a report","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns a single report's definition and current generation state. status moves"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"through queued, processing and then completed or failed, and last_generated_at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and file_path are only populated once a run has finished - use the download"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"endpoint to obtain a link rather than reading file_path directly."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_383","description":"The ID of the report.","required":true}],"pointer":"/paths/~1api~1v2~1report~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1report~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/report/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_383"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/v2/report/{id}","href":"report-module/readareport","openApiOperationId":"readAReport","summary":"Read a report"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_382"}},"schemaId":"schema_382"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1report~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_382","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_382"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/report-module/readareport"}],"panels":[]}]},"httpPath":"/api/v2/report/{id}"},{"label":"Update a report","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/report-module/updateareport","routeSlug":"/api-docs/openapi/report-module/updateareport","metadata":{"seo":{"title":"Update a report","description":"Updates the fields supplied and leaves the rest untouched, then returns thereport in the same shape as reading it. Every field is optional."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateAReport","name":"Update a report","isWebhook":false,"pointer":"/paths/~1api~1v2~1report~1{id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a report","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Updates the fields supplied and leaves the rest untouched, then returns the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"report in the same shape as reading it. Every field is optional."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Updating a report that is not scheduled re-queues it: status is reset to queued,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"error_message is cleared and generation starts again. So this endpoint is also"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"how a report is re-run with different columns or filters. Turning is_scheduled"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"off clears the whole schedule - start_date, start_time, end_date, timezone,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"repeat and destination_meta are all nulled."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_383","description":"The ID of the report.","required":true}],"pointer":"/paths/~1api~1v2~1report~1{id}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1report~1{id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_384"}},"schemaId":"schema_384","pointer":"/paths/~1api~1v2~1report~1{id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v2/report/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_383"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_384"}},"responseCodes":["200","404"],"pointer":"/api/v2/report/{id}","href":"report-module/updateareport","openApiOperationId":"updateAReport","summary":"Update a report"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_384","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_384"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_382"}},"schemaId":"schema_382"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1report~1{id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_382","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_382"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/report-module/updateareport"}],"panels":[]}]},"httpPath":"/api/v2/report/{id}"},{"label":"Delete a report","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/report-module/deleteareport","routeSlug":"/api-docs/openapi/report-module/deleteareport","metadata":{"seo":{"title":"Delete a report","description":"Deletes the report definition, its schedule and the record of any file it has generated."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteAReport","name":"Delete a report","isWebhook":false,"pointer":"/paths/~1api~1v2~1report~1{id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete a report","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Deletes the report definition, its schedule and the record of any file it has\ngenerated."},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_383","description":"The ID of the report.","required":true}],"pointer":"/paths/~1api~1v2~1report~1{id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1report~1{id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/v2/report/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_383"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["204","404"],"pointer":"/api/v2/report/{id}","href":"report-module/deleteareport","openApiOperationId":"deleteAReport","summary":"Delete a report"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"No content, successful deletion","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1report~1{id}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"204","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/report-module/deleteareport"}],"panels":[]}]},"httpPath":"/api/v2/report/{id}"}],"content":{"contentType":"group","meta":{"name":"Report Module"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Report Module","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v2/report","summary":"List reports","prefix":{"name":"get","color":"get"},"badges":[],"link":"/report-module/listreports","deprecated":false},{"title":"/api/v2/report","summary":"Create a report","prefix":{"name":"post","color":"post"},"badges":[],"link":"/report-module/createareport","deprecated":false},{"title":"/api/v2/report/{id}","summary":"Read a report","prefix":{"name":"get","color":"get"},"badges":[],"link":"/report-module/readareport","deprecated":false},{"title":"/api/v2/report/{id}","summary":"Update a report","prefix":{"name":"put","color":"put"},"badges":[],"link":"/report-module/updateareport","deprecated":false},{"title":"/api/v2/report/{id}","summary":"Delete a report","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/report-module/deleteareport","deprecated":false}]}]}]}]}},{"type":"group","label":"Role Offer Module","link":"/api-docs/openapi/role-offer-module","routeSlug":"/api-docs/openapi/role-offer-module","items":[{"label":"List role offers","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/role-offer-module/listroleoffers","routeSlug":"/api-docs/openapi/role-offer-module/listroleoffers","metadata":{"seo":{"title":"List role offers","description":"Returns the account's role offers. Pass a page parameter to receive a paginatedenvelope; without one, every matching role offer is returned as a flat array."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listRoleOffers","name":"List role offers","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1roleoffer/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List role offers","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the account's role offers. Pass a page parameter to receive a paginated"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"envelope; without one, every matching role offer is returned as a flat array."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set demand_available=1 to return only role offers that still have unfilled"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"demand, which is the usual way to build a list of roles someone can apply for."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint does not require authentication, but an anonymous caller only"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"receives results on an account that has public browsing switched on."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"demand_available","in":"query","schemaId":"schema_385","description":"Return only role offers with unfilled demand."},{"name":"per_page","in":"query","schemaId":"schema_262","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of results to return per page. The higher the number the longer the request may take."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is highly recommended to use this to avoid timeouts as your data grows."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate results."},"children":[]}]}]}]},{"name":"page","in":"query","schemaId":"schema_263","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The page of results to return. Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"per_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"results. If not specified, defaults to 1."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response's next_page_url will be null if there are no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"more pages."},"children":[]}]}]}]},{"name":"filter","in":"query","schemaId":"schema_264","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A filter to apply to the results. Declared as an array of objects, where each object"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contains an attr (attribute code), operator and value key. Examples:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=name&filter[0][operator]=like&filter[0][value]=luke"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=id&filter[0][operator]=>&filter[0][value]=265"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the filters documentation for more details on how to use this."},"children":[]}]}]}],"example":null},{"name":"sort_by","in":"query","schemaId":"schema_265","description":"The field to sort the results by. No ordering is applied unless you specify one, so\nrow order is not guaranteed. Always send it when paging through a list, otherwise\nrecords can repeat or be missed between pages.\nExample: id","example":null},{"name":"sort_order","in":"query","schemaId":"schema_266","description":"The direction to sort the results by. Can be 'asc' or 'desc', default is 'asc'.","example":null},{"name":"_locale","in":"query","schemaId":"schema_267","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The locale to use for the response. This primarily affects the results of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contain human-readable labels and terms, as well as locale-specific date formats.,"},"children":[]}]}]}]},{"name":"extras","in":"query","schemaId":"schema_386","description":"A list of extras to include in the response. These are objects or arrays that are not part of\nthe model's primary attributes, such as stats and counts.\nFor fast responses, avoid requesting them if you don't need them. "},{"name":"with","in":"query","schemaId":"schema_387","description":"A list of relations to include in the response. May be single records or collections.\nIt is often more efficient to retrieve this way, to avoid follow-up API calls."}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/headcount/roleoffer","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[{"name":"demand_available","in":"query","required":false,"schemaId":"schema_385"},{"name":"per_page","in":"query","required":false,"schemaId":"schema_262"},{"name":"page","in":"query","required":false,"schemaId":"schema_263"},{"name":"filter","in":"query","required":false,"schemaId":"schema_264"},{"name":"sort_by","in":"query","required":false,"schemaId":"schema_265"},{"name":"sort_order","in":"query","required":false,"schemaId":"schema_266"},{"name":"_locale","in":"query","required":false,"schemaId":"schema_267"},{"name":"extras","in":"query","required":false,"schemaId":"schema_386"},{"name":"with","in":"query","required":false,"schemaId":"schema_387"}],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/headcount/roleoffer","href":"role-offer-module/listroleoffers","openApiOperationId":"listRoleOffers","summary":"List role offers"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_388"}},"schemaId":"schema_388"}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_388","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_388"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/role-offer-module/listroleoffers"}],"panels":[]}]},"httpPath":"/api/v2/headcount/roleoffer"},{"label":"Create a role offer","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/role-offer-module/createaroleoffer","routeSlug":"/api-docs/openapi/role-offer-module/createaroleoffer","metadata":{"seo":{"title":"Create a role offer","description":"Creates a role offer and returns it in the same shape as reading one, so afollow-up read is not needed. A role offer is unique on the combination of jobtitle and venue; reusing a pair that already has one is refused."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createARoleOffer","name":"Create a role offer","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1roleoffer/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a role offer","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Creates a role offer and returns it in the same shape as reading one, so a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"follow-up read is not needed. A role offer is unique on the combination of job"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"title and venue; reusing a pair that already has one is refused."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The account's own attribute configuration takes precedence over the fields"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"listed below. Where an attribute is configured for role offers, its definition"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"replaces the rule documented here, which can change both the accepted format and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"whether the field is required. The presence flags below reflect what the endpoint"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"actually enforces on a default configuration."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supplying role_offer_template_id copies the template's values over anything sent"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"alongside it, so a templated create ignores most of the body. A field can only be"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"kept by sending {field}:override=1 next to it, and only by a caller allowed to"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"override template-locked fields."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Demand is expressed one of two ways. With calculate_demand unset or 0, set"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"static_demand to the number of people needed. With calculate_demand=1, demand is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"derived from user_per_shift, number_of_shifts_per_day, start_date and end_date"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"instead."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Invalid input returns a 422 identifying the fields at fault. Sending both"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"minimum_dob and minimum_age is rejected, as they are two ways to say one thing."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_389"}},"schemaId":"schema_389","pointer":"/paths/~1api~1v2~1headcount~1roleoffer/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/headcount/roleoffer","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_389"}},"responseCodes":["201","404"],"pointer":"/api/v2/headcount/roleoffer","href":"role-offer-module/createaroleoffer","openApiOperationId":"createARoleOffer","summary":"Create a role offer"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_389","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_389"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_390"}},"schemaId":"schema_390"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_390","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_390"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/role-offer-module/createaroleoffer"}],"panels":[]}]},"httpPath":"/api/v2/headcount/roleoffer"},{"label":"Read a role offer","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/role-offer-module/readaroleoffer","routeSlug":"/api-docs/openapi/role-offer-module/readaroleoffer","metadata":{"seo":{"title":"Read a role offer","description":"Returns one role offer's configuration, the human-readable form of each of itsvalues, and what the calling user is permitted to do with it."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"readARoleOffer","name":"Read a role offer","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Read a role offer","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns one role offer's configuration, the human-readable form of each of its"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"values, and what the calling user is permitted to do with it."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"permissions.apply says whether the caller can apply right now. When it is false,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"permissions.apply_error and permissions.apply_code give the reason, which is the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"value to surface rather than a generic message."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the role offer.","required":true}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/headcount/roleoffer/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/v2/headcount/roleoffer/{id}","href":"role-offer-module/readaroleoffer","openApiOperationId":"readARoleOffer","summary":"Read a role offer"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_390"}},"schemaId":"schema_390"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_390","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_390"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/role-offer-module/readaroleoffer"}],"panels":[]}]},"httpPath":"/api/v2/headcount/roleoffer/{id}"},{"label":"Update a role offer","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/role-offer-module/updatearoleoffer","routeSlug":"/api-docs/openapi/role-offer-module/updatearoleoffer","metadata":{"seo":{"title":"Update a role offer","description":"Updates a role offer and returns it in the same shape as reading one. Every fieldis optional; only the fields sent are changed, with the exceptions below."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateARoleOffer","name":"Update a role offer","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a role offer","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Updates a role offer and returns it in the same shape as reading one. Every field"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"is optional; only the fields sent are changed, with the exceptions below."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The account's own attribute configuration takes precedence over the fields listed"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"below, exactly as it does on create."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Four fields are reset rather than left alone when their enabling field is absent"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"from the request. Send expires_in_enable alongside expires_in to keep it,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"enable_waitlist alongside waitlist_demand and waitlist_auto_invitation_enabled,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and has_age_limit alongside minimum_dob and minimum_age. Omitting the enabling"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"field clears the value it guards. Omitting rules clears the role offer's rules."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Where the role offer was created from a template, values the template locks are"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"dropped from the request and the update still returns a 200. A locked field can"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"only be changed by sending {field}:override=1 next to it, and only by a caller"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"allowed to override template-locked fields. The journey a role offer belongs to"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"can never be changed after creation."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Invalid input returns a 422 identifying the fields at fault. Reducing demand below"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"what is already filled, exceeding the account's confidence level, or removing a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"payment requirement that applications depend on are all reported this way."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the role offer.","required":true}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{id}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_391"}},"schemaId":"schema_391","pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v2/headcount/roleoffer/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_391"}},"responseCodes":["200","404"],"pointer":"/api/v2/headcount/roleoffer/{id}","href":"role-offer-module/updatearoleoffer","openApiOperationId":"updateARoleOffer","summary":"Update a role offer"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_391","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_391"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_390"}},"schemaId":"schema_390"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_390","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_390"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/role-offer-module/updatearoleoffer"}],"panels":[]}]},"httpPath":"/api/v2/headcount/roleoffer/{id}"},{"label":"Delete a role offer","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/role-offer-module/deletearoleoffer","routeSlug":"/api-docs/openapi/role-offer-module/deletearoleoffer","metadata":{"seo":{"title":"Delete a role offer","description":"Deletes a role offer. Unlike most deletes this returns 200 with a messages body rather than an empty 204; messages is null when there was nothing to report."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteARoleOffer","name":"Delete a role offer","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete a role offer","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Deletes a role offer. Unlike most deletes this returns 200 with a messages body\nrather than an empty 204; messages is null when there was nothing to report.\n\nDeleting a role offer that people are still assigned to has to be acknowledged\nfirst. The initial attempt is refused with a warning saying how many are affected,\nand the response names the key to acknowledge; send that key back in override to\ngo ahead. Not every caller is permitted to, in which case the delete stays refused."},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the role offer.","required":true}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{id}/delete/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"override","in":"query","schemaId":"schema_392","description":"Warning keys to acknowledge."}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/v2/headcount/roleoffer/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[{"name":"override","in":"query","required":false,"schemaId":"schema_392"}],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/v2/headcount/roleoffer/{id}","href":"role-offer-module/deletearoleoffer","openApiOperationId":"deleteARoleOffer","summary":"Delete a role offer"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_337"}},"schemaId":"schema_337"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{id}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_337","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_337"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/role-offer-module/deletearoleoffer"}],"panels":[]}]},"httpPath":"/api/v2/headcount/roleoffer/{id}"},{"label":"List a role offer's applications","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/role-offer-module/listaroleoffersapplications","routeSlug":"/api-docs/openapi/role-offer-module/listaroleoffersapplications","metadata":{"seo":{"title":"List a role offer's applications","description":"Returns the people who have applied to, or been added to, the role offer inthe URL - one row per application, carrying the status each is at."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listARoleOffersApplications","name":"List a role offer's applications","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{roleoffer_id}~1user/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List a role offer's applications","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the people who have applied to, or been added to, the role offer in"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the URL - one row per application, carrying the status each is at."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Applications whose user has since been deleted are "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"included"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", unlike most"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"listings in the API, so the count here matches what the role offer's demand is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"measured against."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response is only wrapped in a paginated envelope when a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"sent. Without one, every match comes back as a flat array. Note that the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"envelope carries no "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"total"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and no "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"last_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - page until "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next_page_url"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"null rather than counting pages up front."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Related records are not included unless asked for. Requesting the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"relation returns that person's full profile, so ask for it only when the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"profile is what you need - the application already carries "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"roleoffer_id","in":"path","schemaId":"schema_317","description":"The ID of the role offer.","required":true}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{roleoffer_id}~1user/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"per_page","in":"query","schemaId":"schema_262","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of results to return per page. The higher the number the longer the request may take."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is highly recommended to use this to avoid timeouts as your data grows."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate results."},"children":[]}]}]}]},{"name":"page","in":"query","schemaId":"schema_263","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The page of results to return. Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"per_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"results. If not specified, defaults to 1."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response's next_page_url will be null if there are no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"more pages."},"children":[]}]}]}]},{"name":"filter","in":"query","schemaId":"schema_264","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A filter to apply to the results. Declared as an array of objects, where each object"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contains an attr (attribute code), operator and value key. Examples:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=name&filter[0][operator]=like&filter[0][value]=luke"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=id&filter[0][operator]=>&filter[0][value]=265"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the filters documentation for more details on how to use this."},"children":[]}]}]}],"example":null},{"name":"sort_by","in":"query","schemaId":"schema_265","description":"The field to sort the results by. No ordering is applied unless you specify one, so\nrow order is not guaranteed. Always send it when paging through a list, otherwise\nrecords can repeat or be missed between pages.\nExample: id","example":null},{"name":"sort_order","in":"query","schemaId":"schema_266","description":"The direction to sort the results by. Can be 'asc' or 'desc', default is 'asc'.","example":null},{"name":"_locale","in":"query","schemaId":"schema_267","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The locale to use for the response. This primarily affects the results of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contain human-readable labels and terms, as well as locale-specific date formats.,"},"children":[]}]}]}]},{"name":"extras","in":"query","schemaId":"schema_393","description":"A list of extras to include in the response. These are objects or arrays that are not part of\nthe model's primary attributes, such as stats and counts.\nFor fast responses, avoid requesting them if you don't need them. "},{"name":"with","in":"query","schemaId":"schema_394","description":"A list of relations to include in the response. May be single records or collections.\nIt is often more efficient to retrieve this way, to avoid follow-up API calls."}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{roleoffer_id}~1user/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{roleoffer_id}~1user/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/headcount/roleoffer/{roleoffer_id}/user","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"roleoffer_id","in":"path","required":true,"schemaId":"schema_317"}],"query":[{"name":"per_page","in":"query","required":false,"schemaId":"schema_262"},{"name":"page","in":"query","required":false,"schemaId":"schema_263"},{"name":"filter","in":"query","required":false,"schemaId":"schema_264"},{"name":"sort_by","in":"query","required":false,"schemaId":"schema_265"},{"name":"sort_order","in":"query","required":false,"schemaId":"schema_266"},{"name":"_locale","in":"query","required":false,"schemaId":"schema_267"},{"name":"extras","in":"query","required":false,"schemaId":"schema_393"},{"name":"with","in":"query","required":false,"schemaId":"schema_394"}],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/headcount/roleoffer/{roleoffer_id}/user","href":"role-offer-module/listaroleoffersapplications","openApiOperationId":"listARoleOffersApplications","summary":"List a role offer's applications"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_395"}},"schemaId":"schema_395"}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{roleoffer_id}~1user/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_395","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_395"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/role-offer-module/listaroleoffersapplications"}],"panels":[]}]},"httpPath":"/api/v2/headcount/roleoffer/{roleoffer_id}/user"},{"label":"Add a user to a role offer","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/role-offer-module/addausertoaroleoffer","routeSlug":"/api-docs/openapi/role-offer-module/addausertoaroleoffer","metadata":{"seo":{"title":"Add a user to a role offer","description":"Creates an application for one person against the role offer in the URL, at thestatus you name, and returns it."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"addAUserToARoleOffer","name":"Add a user to a role offer","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{roleoffer_id}~1user/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Add a user to a role offer","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Creates an application for one person against the role offer in the URL, at the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"status you name, and returns it."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The created record carries only the fields the create set - the rest of an"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"application's fields are filled in as it progresses - so read it back if you"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"need the full shape."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A person can hold only one live application per role offer. A second one comes"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"back as a "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"422"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" naming "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; delete the existing application first if you"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"mean to start over."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Three business rules can refuse an otherwise valid create, each with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"403"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and a message saying which:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the role offer has no places left at that status, either on its main demand,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"its waitlist, its reserve list or its secondary allowance;"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the person already holds as many roles as the account permits;"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the account does not allow an application to start at that status."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A fourth returns a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"405"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", because it is a limit an authorised caller may"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"choose to pass: adding this person would take the role offer past its confidence"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"level. The body carries a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reference"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and a caller holding the matching"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"permission can repeat the request with that key in an "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"override"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"query"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"parameter"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"?override[]=headcount.roleoffer.confidence_level"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - to go ahead."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sending "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"override"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the JSON body does not work."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Beyond the fields listed here the endpoint also accepts the account's own"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"configured attributes for an application. Invalid input returns a 422 naming the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"fields at fault."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"roleoffer_id","in":"path","schemaId":"schema_317","description":"The ID of the role offer.","required":true}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{roleoffer_id}~1user/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{roleoffer_id}~1user/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_396"}},"schemaId":"schema_396","pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{roleoffer_id}~1user/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/headcount/roleoffer/{roleoffer_id}/user","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"roleoffer_id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_396"}},"responseCodes":["201","403","404","405"],"pointer":"/api/v2/headcount/roleoffer/{roleoffer_id}/user","href":"role-offer-module/addausertoaroleoffer","openApiOperationId":"addAUserToARoleOffer","summary":"Add a user to a role offer"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_396","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_396"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_397"}},"schemaId":"schema_397"},{"code":"403","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_398"}},"schemaId":"schema_398"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"},{"code":"405","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_399"}},"schemaId":"schema_399"}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{roleoffer_id}~1user/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_397","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_397"}}},{"code":"403","schemaId":"schema_398","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_398"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}},{"code":"405","schemaId":"schema_399","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_399"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/role-offer-module/addausertoaroleoffer"}],"panels":[]}]},"httpPath":"/api/v2/headcount/roleoffer/{roleoffer_id}/user"},{"label":"Add many users to a role offer","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/role-offer-module/addmanyuserstoaroleoffer","routeSlug":"/api-docs/openapi/role-offer-module/addmanyuserstoaroleoffer","metadata":{"seo":{"title":"Add many users to a role offer","description":"Adds a set of people to the role offer in the URL at once."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"addManyUsersToARoleOffer","name":"Add many users to a role offer","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{roleoffer_id}~1user/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Add many users to a role offer","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Adds a set of people to the role offer in the URL at once."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This write is queued."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" The response does not contain the applications and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"does not mean they exist yet - it means the request was accepted and the work is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"running in the background. The payload is a single "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"queue"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field holding an"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"identifier for that work. There is no endpoint that resolves the identifier, so"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"confirm the outcome by listing the role offer's applications."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Choose the people either way round:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"applyTo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" holding the user IDs to add."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send any other "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"applyTo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" value to add every user the caller can see, narrowed"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"by an optional "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filter"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the same form the user listing accepts."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"People who already hold an application on this role offer are skipped, so the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"same request can be repeated safely."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The same demand, allowance and transition limits the single create is subject to"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"apply to each person here, but because the work is queued they cannot be reported"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"back: a person the limits refuse is skipped and the request still returns a queue"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"token. "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A request whose fields are all valid therefore always succeeds, whether"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"or not anybody is added."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Only malformed input is refused, with a 422 before"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"anything is queued."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"roleoffer_id","in":"path","schemaId":"schema_317","description":"The ID of the role offer.","required":true}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{roleoffer_id}~1user/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{roleoffer_id}~1user/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_400"}},"schemaId":"schema_400","pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{roleoffer_id}~1user/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v2/headcount/roleoffer/{roleoffer_id}/user","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"roleoffer_id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_400"}},"responseCodes":["200"],"pointer":"/api/v2/headcount/roleoffer/{roleoffer_id}/user","href":"role-offer-module/addmanyuserstoaroleoffer","openApiOperationId":"addManyUsersToARoleOffer","summary":"Add many users to a role offer"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_400","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_400"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_284"}},"schemaId":"schema_284"}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{roleoffer_id}~1user/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_284","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_284"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/role-offer-module/addmanyuserstoaroleoffer"}],"panels":[]}]},"httpPath":"/api/v2/headcount/roleoffer/{roleoffer_id}/user"},{"label":"Read an application","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/role-offer-module/readanapplication","routeSlug":"/api-docs/openapi/role-offer-module/readanapplication","metadata":{"seo":{"title":"Read an application","description":"Returns one person's application to a role offer: the status it is at, whenthat status last changed, whether it is a secondary or a reserved place, andany note recorded against it."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"readAnApplication","name":"Read an application","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{roleoffer_id}~1user~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Read an application","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns one person's application to a role offer: the status it is at, when"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"that status last changed, whether it is a secondary or a reserved place, and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"any note recorded against it."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" carries the readable form of the same record - the status as a label,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"its type, the colour the portal shows it in, and the name of the journey step"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the person is on if the role offer has a journey attached. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"value to branch on: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and the label are configured per account, but"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the type behind them is not."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The application must belong to the role offer in the URL; a mismatched pair"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"returns a 404."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"roleoffer_id","in":"path","schemaId":"schema_317","description":"The ID of the role offer.","required":true},{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the application.","required":true}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{roleoffer_id}~1user~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{roleoffer_id}~1user~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/headcount/roleoffer/{roleoffer_id}/user/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"roleoffer_id","in":"path","required":true,"schemaId":"schema_317"},{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/v2/headcount/roleoffer/{roleoffer_id}/user/{id}","href":"role-offer-module/readanapplication","openApiOperationId":"readAnApplication","summary":"Read an application"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_401"}},"schemaId":"schema_401"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{roleoffer_id}~1user~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_401","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_401"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/role-offer-module/readanapplication"}],"panels":[]}]},"httpPath":"/api/v2/headcount/roleoffer/{roleoffer_id}/user/{id}"},{"label":"Update an application","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/role-offer-module/updateanapplication","routeSlug":"/api-docs/openapi/role-offer-module/updateanapplication","metadata":{"seo":{"title":"Update an application","description":"Moves an application to a new status, and optionally records a note or changeswhether it is a secondary or a reserved place. Returns the application in thesame shape as reading it."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateAnApplication","name":"Update an application","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{roleoffer_id}~1user~1{id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update an application","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Moves an application to a new status, and optionally records a note or changes"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"whether it is a secondary or a reserved place. Returns the application in the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"same shape as reading it."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is required on every update"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", so unlike most updates in this API"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"an empty body is a 422 rather than a no-op. Send the status the application"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"should now be at, even if it is the one it is already at. If you do not know the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"account's status ids, send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instead and the matching status is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"resolved for you."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Changing the status is what sets off everything the account has configured to"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"follow it - emails, journey steps, certificates. It is also the point at which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the same limits the create is subject to are re-checked, so an update can come"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"back as a "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"403"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" naming the demand, allowance or transition rule that refused"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"it, or a "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"405"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for the confidence level - see the create for how to pass that"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"one."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Two behaviours worth knowing:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Moving an application off a waitlist reorders the rest of that waitlist, so"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"other applications on the same role offer change as a side effect of this one."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Where the account withdraws people from future shifts when they leave a role,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"moving an application to a status that counts as declined does that too."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"role_offer_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are accepted and ignored: an application cannot be"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"moved to another person or another role offer. Beyond the fields listed here the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"endpoint also accepts the account's own configured attributes for an"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"application."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"roleoffer_id","in":"path","schemaId":"schema_317","description":"The ID of the role offer.","required":true},{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the application.","required":true}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{roleoffer_id}~1user~1{id}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{roleoffer_id}~1user~1{id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_402"}},"schemaId":"schema_402","pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{roleoffer_id}~1user~1{id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v2/headcount/roleoffer/{roleoffer_id}/user/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"roleoffer_id","in":"path","required":true,"schemaId":"schema_317"},{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_402"}},"responseCodes":["200","403","404","405"],"pointer":"/api/v2/headcount/roleoffer/{roleoffer_id}/user/{id}","href":"role-offer-module/updateanapplication","openApiOperationId":"updateAnApplication","summary":"Update an application"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_402","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_402"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_401"}},"schemaId":"schema_401"},{"code":"403","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_403"}},"schemaId":"schema_403"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"},{"code":"405","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_399"}},"schemaId":"schema_399"}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{roleoffer_id}~1user~1{id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_401","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_401"}}},{"code":"403","schemaId":"schema_403","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_403"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}},{"code":"405","schemaId":"schema_399","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_399"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/role-offer-module/updateanapplication"}],"panels":[]}]},"httpPath":"/api/v2/headcount/roleoffer/{roleoffer_id}/user/{id}"},{"label":"Delete an application","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/role-offer-module/deleteanapplication","routeSlug":"/api-docs/openapi/role-offer-module/deleteanapplication","metadata":{"seo":{"title":"Delete an application","description":"Removes a person's application to the role offer, freeing the place it occupied and freeing that person to be added to the role offer again."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteAnApplication","name":"Delete an application","isWebhook":false,"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{roleoffer_id}~1user~1{id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete an application","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Removes a person's application to the role offer, freeing the place it occupied\nand freeing that person to be added to the role offer again.\n\nThe status history recorded against the application goes with it, so if you need\nthat history, read it before deleting."},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"roleoffer_id","in":"path","schemaId":"schema_317","description":"The ID of the role offer.","required":true},{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the application.","required":true}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{roleoffer_id}~1user~1{id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{roleoffer_id}~1user~1{id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/v2/headcount/roleoffer/{roleoffer_id}/user/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"roleoffer_id","in":"path","required":true,"schemaId":"schema_317"},{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["204","404"],"pointer":"/api/v2/headcount/roleoffer/{roleoffer_id}/user/{id}","href":"role-offer-module/deleteanapplication","openApiOperationId":"deleteAnApplication","summary":"Delete an application"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"No content, successful deletion","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1headcount~1roleoffer~1{roleoffer_id}~1user~1{id}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"204","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/role-offer-module/deleteanapplication"}],"panels":[]}]},"httpPath":"/api/v2/headcount/roleoffer/{roleoffer_id}/user/{id}"}],"content":{"contentType":"group","meta":{"name":"Role Offer Module"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Role Offer Module","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v2/headcount/roleoffer","summary":"List role offers","prefix":{"name":"get","color":"get"},"badges":[],"link":"/role-offer-module/listroleoffers","deprecated":false},{"title":"/api/v2/headcount/roleoffer","summary":"Create a role offer","prefix":{"name":"post","color":"post"},"badges":[],"link":"/role-offer-module/createaroleoffer","deprecated":false},{"title":"/api/v2/headcount/roleoffer/{id}","summary":"Read a role offer","prefix":{"name":"get","color":"get"},"badges":[],"link":"/role-offer-module/readaroleoffer","deprecated":false},{"title":"/api/v2/headcount/roleoffer/{id}","summary":"Update a role offer","prefix":{"name":"put","color":"put"},"badges":[],"link":"/role-offer-module/updatearoleoffer","deprecated":false},{"title":"/api/v2/headcount/roleoffer/{id}","summary":"Delete a role offer","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/role-offer-module/deletearoleoffer","deprecated":false},{"title":"/api/v2/headcount/roleoffer/{roleoffer_id}/user","summary":"List a role offer's applications","prefix":{"name":"get","color":"get"},"badges":[],"link":"/role-offer-module/listaroleoffersapplications","deprecated":false},{"title":"/api/v2/headcount/roleoffer/{roleoffer_id}/user","summary":"Add a user to a role offer","prefix":{"name":"post","color":"post"},"badges":[],"link":"/role-offer-module/addausertoaroleoffer","deprecated":false},{"title":"/api/v2/headcount/roleoffer/{roleoffer_id}/user","summary":"Add many users to a role offer","prefix":{"name":"put","color":"put"},"badges":[],"link":"/role-offer-module/addmanyuserstoaroleoffer","deprecated":false},{"title":"/api/v2/headcount/roleoffer/{roleoffer_id}/user/{id}","summary":"Read an application","prefix":{"name":"get","color":"get"},"badges":[],"link":"/role-offer-module/readanapplication","deprecated":false},{"title":"/api/v2/headcount/roleoffer/{roleoffer_id}/user/{id}","summary":"Update an application","prefix":{"name":"put","color":"put"},"badges":[],"link":"/role-offer-module/updateanapplication","deprecated":false},{"title":"/api/v2/headcount/roleoffer/{roleoffer_id}/user/{id}","summary":"Delete an application","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/role-offer-module/deleteanapplication","deprecated":false}]}]}]}]}},{"type":"group","label":"Event Module","link":"/api-docs/openapi/event-module","routeSlug":"/api-docs/openapi/event-module","items":[{"label":"List events","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/event-module/listevents","routeSlug":"/api-docs/openapi/event-module/listevents","metadata":{"seo":{"title":"List events","description":"Returns the events in the account you are calling as."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listEvents","name":"List events","isWebhook":false,"pointer":"/paths/~1api~1v2~1event/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List events","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns the events in the account you are calling as.\n\nWhat comes back depends on who is asking. A caller who may read events gets every\nevent, published or not. A caller who may not gets only events that are published\nand approved. An anonymous caller gets only events that are both public and\npublished, and only on an account that has public browsing turned on - otherwise\nthe endpoint answers as though it does not exist.\n\nEvents still being drafted in the admin console are never returned to anyone but\nthe person drafting them."},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"per_page","in":"query","schemaId":"schema_262","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of results to return per page. The higher the number the longer the request may take."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is highly recommended to use this to avoid timeouts as your data grows."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate results."},"children":[]}]}]}]},{"name":"page","in":"query","schemaId":"schema_263","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The page of results to return. Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"per_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"results. If not specified, defaults to 1."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response's next_page_url will be null if there are no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"more pages."},"children":[]}]}]}]},{"name":"filter","in":"query","schemaId":"schema_264","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A filter to apply to the results. Declared as an array of objects, where each object"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contains an attr (attribute code), operator and value key. Examples:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=name&filter[0][operator]=like&filter[0][value]=luke"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=id&filter[0][operator]=>&filter[0][value]=265"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the filters documentation for more details on how to use this."},"children":[]}]}]}],"example":null},{"name":"sort_by","in":"query","schemaId":"schema_265","description":"The field to sort the results by. No ordering is applied unless you specify one, so\nrow order is not guaranteed. Always send it when paging through a list, otherwise\nrecords can repeat or be missed between pages.\nExample: id","example":null},{"name":"sort_order","in":"query","schemaId":"schema_266","description":"The direction to sort the results by. Can be 'asc' or 'desc', default is 'asc'.","example":null},{"name":"_locale","in":"query","schemaId":"schema_267","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The locale to use for the response. This primarily affects the results of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contain human-readable labels and terms, as well as locale-specific date formats.,"},"children":[]}]}]}]},{"name":"extras","in":"query","schemaId":"schema_271","description":"A list of extras to include in the response. These are objects or arrays that are not part of\nthe model's primary attributes, such as stats and counts.\nFor fast responses, avoid requesting them if you don't need them. "},{"name":"with","in":"query","schemaId":"schema_272","description":"A list of relations to include in the response. May be single records or collections.\nIt is often more efficient to retrieve this way, to avoid follow-up API calls."}],"pointer":"/paths/~1api~1v2~1event/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1event/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/event","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[{"name":"per_page","in":"query","required":false,"schemaId":"schema_262"},{"name":"page","in":"query","required":false,"schemaId":"schema_263"},{"name":"filter","in":"query","required":false,"schemaId":"schema_264"},{"name":"sort_by","in":"query","required":false,"schemaId":"schema_265"},{"name":"sort_order","in":"query","required":false,"schemaId":"schema_266"},{"name":"_locale","in":"query","required":false,"schemaId":"schema_267"},{"name":"extras","in":"query","required":false,"schemaId":"schema_271"},{"name":"with","in":"query","required":false,"schemaId":"schema_272"}],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/event","href":"event-module/listevents","openApiOperationId":"listEvents","summary":"List events"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_404"}},"schemaId":"schema_404"}],"pointer":"/paths/~1api~1v2~1event/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_404","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_404"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/event-module/listevents"}],"panels":[]}]},"httpPath":"/api/v2/event"},{"label":"Create an event","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/event-module/createanevent","routeSlug":"/api-docs/openapi/event-module/createanevent","metadata":{"seo":{"title":"Create an event","description":"Creates an event in the account you are calling as. The response is the same shapeas reading the event back, so a follow-up read is not needed."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createAnEvent","name":"Create an event","isWebhook":false,"pointer":"/paths/~1api~1v2~1event/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create an event","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Creates an event in the account you are calling as. The response is the same shape"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"as reading the event back, so a follow-up read is not needed."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Only "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"description"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" have to be sent."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Everything the rules below mark"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"required beyond those two is filled in from the account's own defaults before the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"request is validated - the timezone, the five shift status defaults, the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"publication status - and the event type falls back to the first one the account"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"has. New events are created unpublished."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An event needs a location."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Send an "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"address"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"headcount_location_venue_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or set "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"is_virtual"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A request with none of the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"three is rejected even though each of them is individually optional."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"event_template_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to build the event from one of the account's templates."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The template's values are applied over the rest of the request, so a field the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"template sets wins over the one you send."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Where the account has attribute prefilling turned on, fields you leave out may"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"come back with values of their own, taken from the defaults configured for your"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"role. Read the response rather than assuming an omitted field is empty."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The account's own configured attributes are accepted as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"custom_*"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" fields."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1event/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_405"}},"schemaId":"schema_405","pointer":"/paths/~1api~1v2~1event/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/event","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_405"}},"responseCodes":["201","404"],"pointer":"/api/v2/event","href":"event-module/createanevent","openApiOperationId":"createAnEvent","summary":"Create an event"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_405","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_405"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_406"}},"schemaId":"schema_406"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1event/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_406","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_406"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/event-module/createanevent"}],"panels":[]}]},"httpPath":"/api/v2/event"},{"label":"Read an event","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/event-module/readanevent","routeSlug":"/api-docs/openapi/event-module/readanevent","metadata":{"seo":{"title":"Read an event","description":"Returns one event: when and where it runs, when applications open and close, whomay see it, and the defaults every shift beneath it inherits - the statuses anapplication moves through, the forms it collects, the check-in window and thelimits on how many shifts one person may hold."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"readAnEvent","name":"Read an event","isWebhook":false,"pointer":"/paths/~1api~1v2~1event~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Read an event","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns one event: when and where it runs, when applications open and close, who"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"may see it, and the defaults every shift beneath it inherits - the statuses an"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"application moves through, the forms it collects, the check-in window and the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"limits on how many shifts one person may hold."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" block repeats the same values rendered for display - dates in the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"event's timezone, ids resolved to the names behind them - so a listing can be"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"shown without resolving each id yourself."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_407","description":"The ID of the event.","required":true}],"pointer":"/paths/~1api~1v2~1event~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1event~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/event/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_407"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/v2/event/{id}","href":"event-module/readanevent","openApiOperationId":"readAnEvent","summary":"Read an event"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_406"}},"schemaId":"schema_406"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1event~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_406","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_406"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/event-module/readanevent"}],"panels":[]}]},"httpPath":"/api/v2/event/{id}"},{"label":"Update an event","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/event-module/updateanevent","routeSlug":"/api-docs/openapi/event-module/updateanevent","metadata":{"seo":{"title":"Update an event","description":"Updates an event and returns it, the same shape as reading it. Every field isoptional; a request with an empty body succeeds and changes nothing."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateAnEvent","name":"Update an event","isWebhook":false,"pointer":"/paths/~1api~1v2~1event~1{id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update an event","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Updates an event and returns it, the same shape as reading it. Every field is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"optional; a request with an empty body succeeds and changes nothing."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sending a date onto an ongoing event ends its ongoing state."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" A start or end"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"timestamp on an event marked ongoing clears that flag, because an event cannot be"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"both. Marking it ongoing does the reverse and clears both timestamps."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Where the event was built from a template, the template's fields are ignored"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"unless you are allowed to override them - they are dropped from the request rather"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"than rejected, so the call still succeeds and those fields keep their old values."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The same is true of any field locked on the event itself."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An account that requires events to be approved refuses changes to anything other"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"than the status and the approval fields once the event has been approved, and says"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"so per field."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The account's own configured attributes are accepted as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"custom_*"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" fields."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_407","description":"The ID of the event.","required":true}],"pointer":"/paths/~1api~1v2~1event~1{id}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1event~1{id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_408"}},"schemaId":"schema_408","pointer":"/paths/~1api~1v2~1event~1{id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v2/event/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_407"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_408"}},"responseCodes":["200","404"],"pointer":"/api/v2/event/{id}","href":"event-module/updateanevent","openApiOperationId":"updateAnEvent","summary":"Update an event"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_408","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_408"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_406"}},"schemaId":"schema_406"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1event~1{id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_406","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_406"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/event-module/updateanevent"}],"panels":[]}]},"httpPath":"/api/v2/event/{id}"},{"label":"Delete an event","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/event-module/deleteanevent","routeSlug":"/api-docs/openapi/event-module/deleteanevent","metadata":{"seo":{"title":"Delete an event","description":"Removes an event. The record is retained rather than erased, but no endpointrestores it, so treat this as final."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteAnEvent","name":"Delete an event","isWebhook":false,"pointer":"/paths/~1api~1v2~1event~1{id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete an event","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Removes an event. The record is retained rather than erased, but no endpoint"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"restores it, so treat this as final."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This delete answers "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"200"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", not the usual "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"204"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" The body carries "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"messages"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"list of notices raised while deleting - for example when the event was still in use"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"elsewhere in the account. It is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when there is nothing to say."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_407","description":"The ID of the event.","required":true}],"pointer":"/paths/~1api~1v2~1event~1{id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1event~1{id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/v2/event/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_407"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/v2/event/{id}","href":"event-module/deleteanevent","openApiOperationId":"deleteAnEvent","summary":"Delete an event"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_337"}},"schemaId":"schema_337"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1event~1{id}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_337","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_337"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/event-module/deleteanevent"}],"panels":[]}]},"httpPath":"/api/v2/event/{id}"}],"content":{"contentType":"group","meta":{"name":"Event Module"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Event Module","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v2/event","summary":"List events","prefix":{"name":"get","color":"get"},"badges":[],"link":"/event-module/listevents","deprecated":false},{"title":"/api/v2/event","summary":"Create an event","prefix":{"name":"post","color":"post"},"badges":[],"link":"/event-module/createanevent","deprecated":false},{"title":"/api/v2/event/{id}","summary":"Read an event","prefix":{"name":"get","color":"get"},"badges":[],"link":"/event-module/readanevent","deprecated":false},{"title":"/api/v2/event/{id}","summary":"Update an event","prefix":{"name":"put","color":"put"},"badges":[],"link":"/event-module/updateanevent","deprecated":false},{"title":"/api/v2/event/{id}","summary":"Delete an event","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/event-module/deleteanevent","deprecated":false}]}]}]}]}},{"type":"group","label":"Shift Module","link":"/api-docs/openapi/shift-module","routeSlug":"/api-docs/openapi/shift-module","items":[{"label":"List shift assignments","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/shift-module/listshiftassignments","routeSlug":"/api-docs/openapi/shift-module/listshiftassignments","metadata":{"seo":{"title":"List shift assignments","description":"Returns one row per person-on-a-shift, carrying the status they are at and thetimes they checked in and out."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listShiftAssignments","name":"List shift assignments","isWebhook":false,"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1user/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List shift assignments","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns one row per person-on-a-shift, carrying the status they are at and the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"times they checked in and out."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The same listing is published on two paths and they differ in scope."},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/event/{event_id}/shift/{shift_id}/user"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returns the people on that one shift."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/event/shift/user"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returns every assignment in the account, across every event,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and is the one to reach for when you are syncing rather than looking at a single"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"shift - narrow it with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filter"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and page through it."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response is only wrapped in a paginated envelope when a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"sent. Without one, every match comes back as a flat array. The envelope carries"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"no "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"total"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and no "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"last_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - page until "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next_page_url"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is null rather than"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"counting pages up front."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Rows carry no related records at all, whichever path you use. The person's name"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and the shift's name are on the row as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice.user_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice.shift_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":";"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"for anything more, read the user or the shift by the ids the row carries."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"event_id","in":"path","schemaId":"schema_409","description":"The ID of the event.","required":true},{"name":"shift_id","in":"path","schemaId":"schema_410","description":"The ID of the shift.","required":true}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1user/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"scan","in":"query","schemaId":"schema_411","description":"Match people by name, email, phone or reference, the way\nthe console's search box does."},{"name":"active","in":"query","schemaId":"schema_412","description":"Keep only assignments at a status that counts towards\nthe shift's demand."},{"name":"leader","in":"query","schemaId":"schema_413","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Keep only assignments at an active status. On"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/event/shift/user"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", where no shift is named, this also narrows the results to"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"shifts starting within twelve hours either side of now, and a caller who cannot"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"update shift assignments sees only the shifts they lead."},"children":[]}]}]}]},{"name":"per_page","in":"query","schemaId":"schema_262","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of results to return per page. The higher the number the longer the request may take."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is highly recommended to use this to avoid timeouts as your data grows."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate results."},"children":[]}]}]}]},{"name":"page","in":"query","schemaId":"schema_263","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The page of results to return. Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"per_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"results. If not specified, defaults to 1."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response's next_page_url will be null if there are no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"more pages."},"children":[]}]}]}]},{"name":"filter","in":"query","schemaId":"schema_264","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A filter to apply to the results. Declared as an array of objects, where each object"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contains an attr (attribute code), operator and value key. Examples:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=name&filter[0][operator]=like&filter[0][value]=luke"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=id&filter[0][operator]=>&filter[0][value]=265"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the filters documentation for more details on how to use this."},"children":[]}]}]}],"example":null},{"name":"sort_by","in":"query","schemaId":"schema_265","description":"The field to sort the results by. No ordering is applied unless you specify one, so\nrow order is not guaranteed. Always send it when paging through a list, otherwise\nrecords can repeat or be missed between pages.\nExample: id","example":null},{"name":"sort_order","in":"query","schemaId":"schema_266","description":"The direction to sort the results by. Can be 'asc' or 'desc', default is 'asc'.","example":null},{"name":"_locale","in":"query","schemaId":"schema_267","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The locale to use for the response. This primarily affects the results of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contain human-readable labels and terms, as well as locale-specific date formats.,"},"children":[]}]}]}]},{"name":"extras","in":"query","schemaId":"schema_414","description":"A list of extras to include in the response. These are objects or arrays that are not part of\nthe model's primary attributes, such as stats and counts.\nFor fast responses, avoid requesting them if you don't need them. "},{"name":"with","in":"query","schemaId":"schema_415","description":"A list of relations to include in the response. May be single records or collections.\nIt is often more efficient to retrieve this way, to avoid follow-up API calls."}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1user/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1user/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/event/{event_id}/shift/{shift_id}/user","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"event_id","in":"path","required":true,"schemaId":"schema_409"},{"name":"shift_id","in":"path","required":true,"schemaId":"schema_410"}],"query":[{"name":"scan","in":"query","required":false,"schemaId":"schema_411"},{"name":"active","in":"query","required":false,"schemaId":"schema_412"},{"name":"leader","in":"query","required":false,"schemaId":"schema_413"},{"name":"per_page","in":"query","required":false,"schemaId":"schema_262"},{"name":"page","in":"query","required":false,"schemaId":"schema_263"},{"name":"filter","in":"query","required":false,"schemaId":"schema_264"},{"name":"sort_by","in":"query","required":false,"schemaId":"schema_265"},{"name":"sort_order","in":"query","required":false,"schemaId":"schema_266"},{"name":"_locale","in":"query","required":false,"schemaId":"schema_267"},{"name":"extras","in":"query","required":false,"schemaId":"schema_414"},{"name":"with","in":"query","required":false,"schemaId":"schema_415"}],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/event/{event_id}/shift/{shift_id}/user","href":"shift-module/listshiftassignments","openApiOperationId":"listShiftAssignments","summary":"List shift assignments"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_416"}},"schemaId":"schema_416"}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1user/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_416","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_416"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/shift-module/listshiftassignments"}],"panels":[]}]},"httpPath":"/api/v2/event/{event_id}/shift/{shift_id}/user"},{"label":"Put a person on a shift","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/shift-module/putapersononashift","routeSlug":"/api-docs/openapi/shift-module/putapersononashift","metadata":{"seo":{"title":"Put a person on a shift","description":"Creates one assignment against the shift in the URL, at the status you name, andreturns it."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"putAPersonOnAShift","name":"Put a person on a shift","isWebhook":false,"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1user/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Put a person on a shift","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Creates one assignment against the shift in the URL, at the status you name, and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"returns it."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The created record carries only the fields the create set - the rest are filled"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"in as the shift runs - so read it back if you need the full shape."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"swap_from_shift_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" turns this into a move rather than an add."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Send it and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the person is taken off that shift as part of the same request, then put on this"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"one; their assignment on the old shift is deleted, along with the same person's"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"assignment for any family member you named. Leave it out and nothing is removed."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Because it changes what the endpoint does, it is also authorised differently: a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"plain add needs only the access to create an assignment, while a move needs"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"either the access to move people between shifts or both create "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" delete."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A caller without that gets a 404 rather than a create."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"family_member_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" adds several people in one call - the person in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user_id"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"plus any of their own family members you name. The response is the assignment for"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; read the shift's assignments back for the rest."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"repeat"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" extends the create to every later shift linked to this one, so one call"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"can put someone on a whole recurring series."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A status the account treats as cancelled is refused, and so is a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"demand"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" larger"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"than the places the shift has left. Both come back as a 422 naming the field."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Beyond the fields listed here the endpoint also accepts the account's own"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"configured attributes for an assignment."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint honours the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"trigger_automation"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" request option. It honours"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dry_run"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"only for callers whose access allows it"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - for anyone else the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"option is ignored and the write goes ahead, with no sign in the response that a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"preview was asked for. See "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request options"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"event_id","in":"path","schemaId":"schema_409","description":"The ID of the event.","required":true},{"name":"shift_id","in":"path","schemaId":"schema_410","description":"The ID of the shift.","required":true}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1user/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1user/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_417"}},"schemaId":"schema_417","pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1user/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/event/{event_id}/shift/{shift_id}/user","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"event_id","in":"path","required":true,"schemaId":"schema_409"},{"name":"shift_id","in":"path","required":true,"schemaId":"schema_410"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_417"}},"responseCodes":["201","404"],"pointer":"/api/v2/event/{event_id}/shift/{shift_id}/user","href":"shift-module/putapersononashift","openApiOperationId":"putAPersonOnAShift","summary":"Put a person on a shift"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_417","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_417"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_418"}},"schemaId":"schema_418"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1user/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_418","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_418"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/shift-module/putapersononashift"}],"panels":[]}]},"httpPath":"/api/v2/event/{event_id}/shift/{shift_id}/user"},{"label":"Read a shift assignment","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/shift-module/readashiftassignment","routeSlug":"/api-docs/openapi/shift-module/readashiftassignment","metadata":{"seo":{"title":"Read a shift assignment","description":"Returns one person's place on one shift: the status they are at, the times they checked in and out, the break they took, any rating recorded, and the account's own configured attributes for an assignment."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"readAShiftAssignment","name":"Read a shift assignment","isWebhook":false,"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1user~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Read a shift assignment","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns one person's place on one shift: the status they are at, the times they\nchecked in and out, the break they took, any rating recorded, and the account's\nown configured attributes for an assignment.\n\nAll three ids in the URL have to line up - the shift must belong to the event and\nthe assignment must belong to the shift - otherwise the response is a 404."},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"event_id","in":"path","schemaId":"schema_419","description":"The ID of the event.","required":true},{"name":"shift_id","in":"path","schemaId":"schema_420","description":"The ID of the shift.","required":true},{"name":"id","in":"path","schemaId":"schema_421","description":"The ID of the shift assignment.","required":true}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1user~1{id}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"leader_mode","in":"query","schemaId":"schema_422","description":"Return the reduced view a shift leader is shown,\ncarrying only the check-in and check-out fields rather than the whole assignment."}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1user~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1user~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/event/{event_id}/shift/{shift_id}/user/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"event_id","in":"path","required":true,"schemaId":"schema_419"},{"name":"shift_id","in":"path","required":true,"schemaId":"schema_420"},{"name":"id","in":"path","required":true,"schemaId":"schema_421"}],"query":[{"name":"leader_mode","in":"query","required":false,"schemaId":"schema_422"}],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/v2/event/{event_id}/shift/{shift_id}/user/{id}","href":"shift-module/readashiftassignment","openApiOperationId":"readAShiftAssignment","summary":"Read a shift assignment"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_423"}},"schemaId":"schema_423"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1user~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_423","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_423"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/shift-module/readashiftassignment"}],"panels":[]}]},"httpPath":"/api/v2/event/{event_id}/shift/{shift_id}/user/{id}"},{"label":"Update a shift assignment","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/shift-module/updateashiftassignment","routeSlug":"/api-docs/openapi/shift-module/updateashiftassignment","metadata":{"seo":{"title":"Update a shift assignment","description":"Moves an assignment to a new status, or records the check-in and check-out times,break, demand, rating or note against it. Returns the assignment in the sameshape as reading it."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateAShiftAssignment","name":"Update a shift assignment","isWebhook":false,"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1user~1{id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a shift assignment","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Moves an assignment to a new status, or records the check-in and check-out times,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"break, demand, rating or note against it. Returns the assignment in the same"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"shape as reading it."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Every field is optional, so an empty body is a no-op that returns the assignment"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"unchanged. "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fields the account has not configured as attributes of an assignment"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"are dropped without comment"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rather than rejected, so a misspelt field name"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"comes back as a 200 that changed nothing - read the response to confirm what"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"landed."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Three changes behave in ways worth knowing before you send them:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Making someone a leader of a shift that already has its full complement of"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"leaders returns a 405."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" The body carries a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reference"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and a caller holding"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the matching permission can repeat the request with that key in an "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"override"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"query parameter"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"?override[]=override_system_limits.event.shift.leader.demand"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" -"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"to raise the shift's leader demand and go ahead. Sending "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"override"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the JSON"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"body does not work."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"On a shift belonging to a linked series, the first attempt returns a 400"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"asking whether the change should apply to the later linked shifts too. Repeat"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the request with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"repeat"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" set to answer it; the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reference"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the body names"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the field to send."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Moving to a status the account treats as cancelled is refused unless the shift"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"itself is cancelled, and clearing "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"start_timestamp"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" while "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"end_timestamp"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"still set is refused. Both are a 422 naming the field."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"feedback"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is kept only when the status being set is one the account treats as"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"not approved; sent with any other status it is discarded."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Beyond the fields listed here the endpoint also accepts the account's own"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"configured attributes for an assignment."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint honours the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"trigger_automation"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" request option. It honours"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dry_run"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"only for callers whose access allows it"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - for anyone else the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"option is ignored and the write goes ahead, with no sign in the response that a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"preview was asked for. See "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request options"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"event_id","in":"path","schemaId":"schema_419","description":"The ID of the event.","required":true},{"name":"shift_id","in":"path","schemaId":"schema_420","description":"The ID of the shift.","required":true},{"name":"id","in":"path","schemaId":"schema_421","description":"The ID of the shift assignment.","required":true}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1user~1{id}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1user~1{id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_424"}},"schemaId":"schema_424","pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1user~1{id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v2/event/{event_id}/shift/{shift_id}/user/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"event_id","in":"path","required":true,"schemaId":"schema_419"},{"name":"shift_id","in":"path","required":true,"schemaId":"schema_420"},{"name":"id","in":"path","required":true,"schemaId":"schema_421"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_424"}},"responseCodes":["200","400","404","405"],"pointer":"/api/v2/event/{event_id}/shift/{shift_id}/user/{id}","href":"shift-module/updateashiftassignment","openApiOperationId":"updateAShiftAssignment","summary":"Update a shift assignment"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_424","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_424"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_423"}},"schemaId":"schema_423"},{"code":"400","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_425"}},"schemaId":"schema_425"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"},{"code":"405","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_426"}},"schemaId":"schema_426"}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1user~1{id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_423","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_423"}}},{"code":"400","schemaId":"schema_425","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_425"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}},{"code":"405","schemaId":"schema_426","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_426"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/shift-module/updateashiftassignment"}],"panels":[]}]},"httpPath":"/api/v2/event/{event_id}/shift/{shift_id}/user/{id}"},{"label":"Take a person off a shift","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/shift-module/takeapersonoffashift","routeSlug":"/api-docs/openapi/shift-module/takeapersonoffashift","metadata":{"seo":{"title":"Take a person off a shift","description":"Removes one assignment. The person and the shift are both left alone; only theirplace on it goes."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"takeAPersonOffAShift","name":"Take a person off a shift","isWebhook":false,"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1user~1{id}/delete","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Take a person off a shift","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Removes one assignment. The person and the shift are both left alone; only their"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"place on it goes."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The record is soft-deleted, so it stops appearing in listings but the history of"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"who was on the shift is kept."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"On a shift belonging to a linked series the first attempt returns a 400"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"asking whether the person should come off the later linked shifts too. Repeat the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"request with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"repeat"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" set to answer it. Sending "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"repeat"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" as true removes them"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"from every later linked shift as well."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"event_id","in":"path","schemaId":"schema_419","description":"The ID of the event.","required":true},{"name":"shift_id","in":"path","schemaId":"schema_420","description":"The ID of the shift.","required":true},{"name":"id","in":"path","schemaId":"schema_421","description":"The ID of the shift assignment.","required":true}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1user~1{id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1user~1{id}/delete/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_427"}},"schemaId":"schema_427","pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1user~1{id}/delete/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/v2/event/{event_id}/shift/{shift_id}/user/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"event_id","in":"path","required":true,"schemaId":"schema_419"},{"name":"shift_id","in":"path","required":true,"schemaId":"schema_420"},{"name":"id","in":"path","required":true,"schemaId":"schema_421"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_427"}},"responseCodes":["204","400","404"],"pointer":"/api/v2/event/{event_id}/shift/{shift_id}/user/{id}","href":"shift-module/takeapersonoffashift","openApiOperationId":"takeAPersonOffAShift","summary":"Take a person off a shift"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_427","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_427"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"No content, successful deletion","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"},{"code":"400","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_428"}},"schemaId":"schema_428"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1user~1{id}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"204","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}},{"code":"400","schemaId":"schema_428","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_428"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/shift-module/takeapersonoffashift"}],"panels":[]}]},"httpPath":"/api/v2/event/{event_id}/shift/{shift_id}/user/{id}"},{"label":"List shift assignments","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/shift-module/listallshiftassignments","routeSlug":"/api-docs/openapi/shift-module/listallshiftassignments","metadata":{"seo":{"title":"List shift assignments","description":"Returns one row per person-on-a-shift, carrying the status they are at and thetimes they checked in and out."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listAllShiftAssignments","name":"List shift assignments","isWebhook":false,"pointer":"/paths/~1api~1v2~1event~1shift~1user/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List shift assignments","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns one row per person-on-a-shift, carrying the status they are at and the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"times they checked in and out."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The same listing is published on two paths and they differ in scope."},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/event/{event_id}/shift/{shift_id}/user"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returns the people on that one shift."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/event/shift/user"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returns every assignment in the account, across every event,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and is the one to reach for when you are syncing rather than looking at a single"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"shift - narrow it with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filter"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and page through it."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response is only wrapped in a paginated envelope when a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"sent. Without one, every match comes back as a flat array. The envelope carries"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"no "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"total"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and no "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"last_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - page until "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next_page_url"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is null rather than"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"counting pages up front."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Rows carry no related records at all, whichever path you use. The person's name"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and the shift's name are on the row as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice.user_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice.shift_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":";"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"for anything more, read the user or the shift by the ids the row carries."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"scan","in":"query","schemaId":"schema_411","description":"Match people by name, email, phone or reference, the way\nthe console's search box does."},{"name":"active","in":"query","schemaId":"schema_412","description":"Keep only assignments at a status that counts towards\nthe shift's demand."},{"name":"leader","in":"query","schemaId":"schema_413","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Keep only assignments at an active status. On"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/event/shift/user"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", where no shift is named, this also narrows the results to"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"shifts starting within twelve hours either side of now, and a caller who cannot"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"update shift assignments sees only the shifts they lead."},"children":[]}]}]}]},{"name":"per_page","in":"query","schemaId":"schema_262","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of results to return per page. The higher the number the longer the request may take."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is highly recommended to use this to avoid timeouts as your data grows."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate results."},"children":[]}]}]}]},{"name":"page","in":"query","schemaId":"schema_263","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The page of results to return. Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"per_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"results. If not specified, defaults to 1."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response's next_page_url will be null if there are no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"more pages."},"children":[]}]}]}]},{"name":"filter","in":"query","schemaId":"schema_264","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A filter to apply to the results. Declared as an array of objects, where each object"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contains an attr (attribute code), operator and value key. Examples:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=name&filter[0][operator]=like&filter[0][value]=luke"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=id&filter[0][operator]=>&filter[0][value]=265"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the filters documentation for more details on how to use this."},"children":[]}]}]}],"example":null},{"name":"sort_by","in":"query","schemaId":"schema_265","description":"The field to sort the results by. No ordering is applied unless you specify one, so\nrow order is not guaranteed. Always send it when paging through a list, otherwise\nrecords can repeat or be missed between pages.\nExample: id","example":null},{"name":"sort_order","in":"query","schemaId":"schema_266","description":"The direction to sort the results by. Can be 'asc' or 'desc', default is 'asc'.","example":null},{"name":"_locale","in":"query","schemaId":"schema_267","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The locale to use for the response. This primarily affects the results of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contain human-readable labels and terms, as well as locale-specific date formats.,"},"children":[]}]}]}]},{"name":"extras","in":"query","schemaId":"schema_414","description":"A list of extras to include in the response. These are objects or arrays that are not part of\nthe model's primary attributes, such as stats and counts.\nFor fast responses, avoid requesting them if you don't need them. "},{"name":"with","in":"query","schemaId":"schema_415","description":"A list of relations to include in the response. May be single records or collections.\nIt is often more efficient to retrieve this way, to avoid follow-up API calls."}],"pointer":"/paths/~1api~1v2~1event~1shift~1user/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1event~1shift~1user/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/event/shift/user","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[{"name":"scan","in":"query","required":false,"schemaId":"schema_411"},{"name":"active","in":"query","required":false,"schemaId":"schema_412"},{"name":"leader","in":"query","required":false,"schemaId":"schema_413"},{"name":"per_page","in":"query","required":false,"schemaId":"schema_262"},{"name":"page","in":"query","required":false,"schemaId":"schema_263"},{"name":"filter","in":"query","required":false,"schemaId":"schema_264"},{"name":"sort_by","in":"query","required":false,"schemaId":"schema_265"},{"name":"sort_order","in":"query","required":false,"schemaId":"schema_266"},{"name":"_locale","in":"query","required":false,"schemaId":"schema_267"},{"name":"extras","in":"query","required":false,"schemaId":"schema_414"},{"name":"with","in":"query","required":false,"schemaId":"schema_415"}],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/event/shift/user","href":"shift-module/listallshiftassignments","openApiOperationId":"listAllShiftAssignments","summary":"List shift assignments"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_429"}},"schemaId":"schema_429"}],"pointer":"/paths/~1api~1v2~1event~1shift~1user/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_429","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_429"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/shift-module/listallshiftassignments"}],"panels":[]}]},"httpPath":"/api/v2/event/shift/user"},{"label":"Add many people to a shift","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/shift-module/addmanypeopletoashift","routeSlug":"/api-docs/openapi/shift-module/addmanypeopletoashift","metadata":{"seo":{"title":"Add many people to a shift","description":"Queues the work of putting a set of people on one shift and returns a token forthe queued job. Nothing is created by the time the response comes back, andthe token is not something you can poll - confirm the outcome by listing theshift's assignments."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"addManyPeopleToAShift","name":"Add many people to a shift","isWebhook":false,"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1user~1mass-create/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Add many people to a shift","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Queues the work of putting a set of people on one shift and returns a token for"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the queued job. "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Nothing is created by the time the response comes back"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the token is not something you can poll - confirm the outcome by listing the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"shift's assignments."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Choose the people either by naming them in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or by sending"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"applyTo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filter"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" describing them. A request whose fields are the right"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"shape always returns a queue token, whether or not the background work then"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"succeeds: a person who cannot go on the shift is skipped rather than reported."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The same action is published on two paths and they name the shift differently."},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/event/{event_id}/shift/{shift_id}/user/mass-create"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" takes it from the URL, and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ignores "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"event_shift_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if you send one. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/event/{event_id}/shift/user/mass-create"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"takes it from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"event_shift_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instead - and reads that "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"only from the query"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"string"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"?event_shift_id=123"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Sending it in the JSON body is not seen and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the request comes back as a 404. Prefer the first form unless you have a reason"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"not to."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Either way the shift has to belong to the event in the URL; a mismatch is a 404."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"event_id","in":"path","schemaId":"schema_409","description":"The ID of the event.","required":true},{"name":"shift_id","in":"path","schemaId":"schema_410","description":"The ID of the shift.","required":true}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1user~1mass-create/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1user~1mass-create/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_430"}},"schemaId":"schema_430","pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1user~1mass-create/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/event/{event_id}/shift/{shift_id}/user/mass-create","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"event_id","in":"path","required":true,"schemaId":"schema_409"},{"name":"shift_id","in":"path","required":true,"schemaId":"schema_410"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_430"}},"responseCodes":["200"],"pointer":"/api/v2/event/{event_id}/shift/{shift_id}/user/mass-create","href":"shift-module/addmanypeopletoashift","openApiOperationId":"addManyPeopleToAShift","summary":"Add many people to a shift"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_430","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_430"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_284"}},"schemaId":"schema_284"}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1user~1mass-create/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_284","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_284"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/shift-module/addmanypeopletoashift"}],"panels":[]}]},"httpPath":"/api/v2/event/{event_id}/shift/{shift_id}/user/mass-create"},{"label":"Add many people to a shift","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/shift-module/addmanypeopletoashiftbyquery","routeSlug":"/api-docs/openapi/shift-module/addmanypeopletoashiftbyquery","metadata":{"seo":{"title":"Add many people to a shift","description":"Queues the work of putting a set of people on one shift and returns a token forthe queued job. Nothing is created by the time the response comes back, andthe token is not something you can poll - confirm the outcome by listing theshift's assignments."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"addManyPeopleToAShiftByQuery","name":"Add many people to a shift","isWebhook":false,"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1user~1mass-create/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Add many people to a shift","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Queues the work of putting a set of people on one shift and returns a token for"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the queued job. "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Nothing is created by the time the response comes back"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the token is not something you can poll - confirm the outcome by listing the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"shift's assignments."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Choose the people either by naming them in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or by sending"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"applyTo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filter"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" describing them. A request whose fields are the right"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"shape always returns a queue token, whether or not the background work then"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"succeeds: a person who cannot go on the shift is skipped rather than reported."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The same action is published on two paths and they name the shift differently."},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/event/{event_id}/shift/{shift_id}/user/mass-create"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" takes it from the URL, and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ignores "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"event_shift_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if you send one. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/event/{event_id}/shift/user/mass-create"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"takes it from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"event_shift_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instead - and reads that "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"only from the query"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"string"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"?event_shift_id=123"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Sending it in the JSON body is not seen and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the request comes back as a 404. Prefer the first form unless you have a reason"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"not to."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Either way the shift has to belong to the event in the URL; a mismatch is a 404."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"event_id","in":"path","schemaId":"schema_409","description":"The ID of the event.","required":true}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1user~1mass-create/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1user~1mass-create/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_430"}},"schemaId":"schema_430","pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1user~1mass-create/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/event/{event_id}/shift/user/mass-create","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"event_id","in":"path","required":true,"schemaId":"schema_409"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_430"}},"responseCodes":["200"],"pointer":"/api/v2/event/{event_id}/shift/user/mass-create","href":"shift-module/addmanypeopletoashiftbyquery","openApiOperationId":"addManyPeopleToAShiftByQuery","summary":"Add many people to a shift"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_430","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_430"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_284"}},"schemaId":"schema_284"}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1user~1mass-create/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_284","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_284"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/shift-module/addmanypeopletoashiftbyquery"}],"panels":[]}]},"httpPath":"/api/v2/event/{event_id}/shift/user/mass-create"},{"label":"Remove many people from shifts","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/shift-module/removemanypeoplefromshifts","routeSlug":"/api-docs/openapi/shift-module/removemanypeoplefromshifts","metadata":{"seo":{"title":"Remove many people from shifts","description":"Queues the work of removing a set of assignments and returns a token for thequeued job. Nothing is removed by the time the response comes back, and thetoken is not something you can poll - confirm the outcome by listing the shift'sassignments."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"removeManyPeopleFromShifts","name":"Remove many people from shifts","isWebhook":false,"pointer":"/paths/~1api~1v2~1event~1shift~1user~1mass-delete/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Remove many people from shifts","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Queues the work of removing a set of assignments and returns a token for the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"queued job. "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Nothing is removed by the time the response comes back"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"token is not something you can poll - confirm the outcome by listing the shift's"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"assignments."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Choose the assignments either by naming them in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or by sending"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"applyTo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filter"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" describing them. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" holds shift assignment IDs"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on a listing row - not user IDs."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note this returns a "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"201"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", where the other queued endpoints in the API return a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"200. The body is the same either way."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1event~1shift~1user~1mass-delete/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_431"}},"schemaId":"schema_431","pointer":"/paths/~1api~1v2~1event~1shift~1user~1mass-delete/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/event/shift/user/mass-delete","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_431"}},"responseCodes":["201"],"pointer":"/api/v2/event/shift/user/mass-delete","href":"shift-module/removemanypeoplefromshifts","openApiOperationId":"removeManyPeopleFromShifts","summary":"Remove many people from shifts"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_431","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_431"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_284"}},"schemaId":"schema_284"}],"pointer":"/paths/~1api~1v2~1event~1shift~1user~1mass-delete/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_284","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_284"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/shift-module/removemanypeoplefromshifts"}],"panels":[]}]},"httpPath":"/api/v2/event/shift/user/mass-delete"},{"label":"Apply for several shifts at once","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/shift-module/applyforseveralshiftsatonce","routeSlug":"/api-docs/openapi/shift-module/applyforseveralshiftsatonce","metadata":{"seo":{"title":"Apply for several shifts at once","description":"Puts the signed-in person on every shift in the body. This is what the cart submitswhen someone has finished choosing shifts, and it is the endpoint that actuallycreates the applications - the check that runs as each shift goes into the cartdoes not."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"applyForSeveralShiftsAtOnce","name":"Apply for several shifts at once","isWebhook":false,"pointer":"/paths/~1api~1v2~1event~1shift~1apply-all/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Apply for several shifts at once","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Puts the signed-in person on every shift in the body. This is what the cart submits"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"when someone has finished choosing shifts, and it is the endpoint that actually"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"creates the applications - the check that runs as each shift goes into the cart"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"does not."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The shifts are not named in the URL; they are the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"shifts"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" array in the body"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":","},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and each entry has to carry both "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"event_shift_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"leader_applied"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" even when"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"leading is not being asked for. An entry missing either comes back as a 422 saying"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"Incorrect data structure\" against "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"shifts"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"All or nothing."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Every shift is checked before any application is made, and one"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"shift that cannot be taken refuses the whole request with a 422 whose "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"errors"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"names each shift and says why. The applications, any payment and any linked-series"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"joins are made together, and a failure anywhere undoes all of it - including"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"voiding a payment that had already been authorised. A 200 with an empty body means"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"every application was made."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Where the event sets a minimum number of shifts per person, or a minimum per shift"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"type, a request that would leave the person short is refused here rather than"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"shift by shift."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sending the same set of shifts twice within ten seconds returns a 429; the second"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"request is treated as a double submission rather than a second application."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1event~1shift~1apply-all/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_432"}},"schemaId":"schema_432","pointer":"/paths/~1api~1v2~1event~1shift~1apply-all/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/event/shift/apply-all","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_432"}},"responseCodes":["200","422","429"],"pointer":"/api/v2/event/shift/apply-all","href":"shift-module/applyforseveralshiftsatonce","openApiOperationId":"applyForSeveralShiftsAtOnce","summary":"Apply for several shifts at once"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_432","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_432"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_311"}},"schemaId":"schema_311"},{"code":"422","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_433"}},"schemaId":"schema_433"},{"code":"429","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_434"}},"schemaId":"schema_434"}],"pointer":"/paths/~1api~1v2~1event~1shift~1apply-all/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_311","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_311"}}},{"code":"422","schemaId":"schema_433","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_433"}}},{"code":"429","schemaId":"schema_434","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_434"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/shift-module/applyforseveralshiftsatonce"}],"panels":[]}]},"httpPath":"/api/v2/event/shift/apply-all"},{"label":"Check a shift's application form","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/shift-module/checkashiftsapplicationform","routeSlug":"/api-docs/openapi/shift-module/checkashiftsapplicationform","metadata":{"seo":{"title":"Check a shift's application form","description":"Runs the answers to a shift's application form through that form's own rules andreturns the values it accepted."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"checkAShiftsApplicationForm","name":"Check a shift's application form","isWebhook":false,"pointer":"/paths/~1api~1v2~1event~1shift~1{shift_id}~1submit-application/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Check a shift's application form","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Runs the answers to a shift's application form through that form's own rules and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"returns the values it accepted."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Nothing is stored and no application is made."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" This is the step before applying:"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"it tells you whether the answers will be accepted, so a form that is wrong is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"caught while the person is still filling it in. Send the same answers as"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"application_form"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on the entry for this shift when you apply."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The fields it accepts are whichever ones your account has configured on the form"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"attached to this shift, under the codes you gave them, so they differ from account"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"to account and from shift to shift. A field that fails its rule comes back as a 422"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"keyed by that code. The response echoes the values back, with any file answers"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"replaced by the URL they were stored at."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A shift with no application form on it returns a 404."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"asLeader"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" decides which permission is checked before any of this happens: with it,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"whether the person can lead the shift, and without it, whether they can take an"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ordinary place on it. It changes nothing about the form itself, and it is not one"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"of the values returned."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"shift_id","in":"path","schemaId":"schema_420","description":"The ID of the shift.","required":true}],"pointer":"/paths/~1api~1v2~1event~1shift~1{shift_id}~1submit-application/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1event~1shift~1{shift_id}~1submit-application/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_435"}},"schemaId":"schema_435","pointer":"/paths/~1api~1v2~1event~1shift~1{shift_id}~1submit-application/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/event/shift/{shift_id}/submit-application","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"shift_id","in":"path","required":true,"schemaId":"schema_420"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_435"}},"responseCodes":["200"],"pointer":"/api/v2/event/shift/{shift_id}/submit-application","href":"shift-module/checkashiftsapplicationform","openApiOperationId":"checkAShiftsApplicationForm","summary":"Check a shift's application form"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_435","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_435"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_436"}},"schemaId":"schema_436"}],"pointer":"/paths/~1api~1v2~1event~1shift~1{shift_id}~1submit-application/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_436","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_436"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/shift-module/checkashiftsapplicationform"}],"panels":[]}]},"httpPath":"/api/v2/event/shift/{shift_id}/submit-application"},{"label":"List the shifts in a series","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/shift-module/listtheshiftsinaseries","routeSlug":"/api-docs/openapi/shift-module/listtheshiftsinaseries","metadata":{"seo":{"title":"List the shifts in a series","description":"Returns the shifts that belong to one shift link, a page at a time. This ishow you see what a repeating shift actually turned into: every occurrence the seriesgenerated, each a full shift with its own times, demand figures, location and statuses."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listTheShiftsInASeries","name":"List the shifts in a series","isWebhook":false,"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1link~1{link_id}~1shift/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List the shifts in a series","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the shifts that belong to one shift link, a page at a time. This is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"how you see what a repeating shift actually turned into: every occurrence the series"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"generated, each a full shift with its own times, demand figures, location and statuses."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Each row carries a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"relations.pivot"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" object holding the two ids that join the shift to the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"series. Rows are the same shape the event's shift listing returns, so anything you can do"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"with a shift from there you can do with one from here."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The rows describe the shifts, not the people on them - demand appears as counts, and who"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"holds a place is read through the shift user endpoints."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"event_id","in":"path","schemaId":"schema_419","description":"The ID of the event.","required":true},{"name":"link_id","in":"path","schemaId":"schema_421","description":"The ID of the shift link.","required":true}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1link~1{link_id}~1shift/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"per_page","in":"query","schemaId":"schema_262","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of results to return per page. The higher the number the longer the request may take."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is highly recommended to use this to avoid timeouts as your data grows."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate results."},"children":[]}]}]}]},{"name":"page","in":"query","schemaId":"schema_263","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The page of results to return. Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"per_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"results. If not specified, defaults to 1."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response's next_page_url will be null if there are no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"more pages."},"children":[]}]}]}]},{"name":"filter","in":"query","schemaId":"schema_264","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A filter to apply to the results. Declared as an array of objects, where each object"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contains an attr (attribute code), operator and value key. Examples:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=name&filter[0][operator]=like&filter[0][value]=luke"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=id&filter[0][operator]=>&filter[0][value]=265"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the filters documentation for more details on how to use this."},"children":[]}]}]}],"example":null},{"name":"sort_by","in":"query","schemaId":"schema_265","description":"The field to sort the results by. No ordering is applied unless you specify one, so\nrow order is not guaranteed. Always send it when paging through a list, otherwise\nrecords can repeat or be missed between pages.\nExample: id","example":null},{"name":"sort_order","in":"query","schemaId":"schema_266","description":"The direction to sort the results by. Can be 'asc' or 'desc', default is 'asc'.","example":null},{"name":"_locale","in":"query","schemaId":"schema_267","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The locale to use for the response. This primarily affects the results of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contain human-readable labels and terms, as well as locale-specific date formats.,"},"children":[]}]}]}]},{"name":"extras","in":"query","schemaId":"schema_437","description":"A list of extras to include in the response. These are objects or arrays that are not part of\nthe model's primary attributes, such as stats and counts.\nFor fast responses, avoid requesting them if you don't need them. "},{"name":"with","in":"query","schemaId":"schema_438","description":"A list of relations to include in the response. May be single records or collections.\nIt is often more efficient to retrieve this way, to avoid follow-up API calls."}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1link~1{link_id}~1shift/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1link~1{link_id}~1shift/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/event/{event_id}/shift/link/{link_id}/shift","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"event_id","in":"path","required":true,"schemaId":"schema_419"},{"name":"link_id","in":"path","required":true,"schemaId":"schema_421"}],"query":[{"name":"per_page","in":"query","required":false,"schemaId":"schema_262"},{"name":"page","in":"query","required":false,"schemaId":"schema_263"},{"name":"filter","in":"query","required":false,"schemaId":"schema_264"},{"name":"sort_by","in":"query","required":false,"schemaId":"schema_265"},{"name":"sort_order","in":"query","required":false,"schemaId":"schema_266"},{"name":"_locale","in":"query","required":false,"schemaId":"schema_267"},{"name":"extras","in":"query","required":false,"schemaId":"schema_437"},{"name":"with","in":"query","required":false,"schemaId":"schema_438"}],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/event/{event_id}/shift/link/{link_id}/shift","href":"shift-module/listtheshiftsinaseries","openApiOperationId":"listTheShiftsInASeries","summary":"List the shifts in a series"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_439"}},"schemaId":"schema_439"}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1link~1{link_id}~1shift/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_439","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_439"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/shift-module/listtheshiftsinaseries"}],"panels":[]}]},"httpPath":"/api/v2/event/{event_id}/shift/link/{link_id}/shift"},{"label":"Read a shift link","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/shift-module/readashiftlink","routeSlug":"/api-docs/openapi/shift-module/readashiftlink","metadata":{"seo":{"title":"Read a shift link","description":"Returns one shift link. A shift link is the series a repeating shift belongs to - thething that makes a run of Saturday shifts one recurring commitment rather than a dozenunrelated ones. It holds the names the series is known by and the pattern its shiftswere generated from; the shifts themselves are read from the listing below."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"readAShiftLink","name":"Read a shift link","isWebhook":false,"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1link~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Read a shift link","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns one shift link. A shift link is the series a repeating shift belongs to - the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"thing that makes a run of Saturday shifts one recurring commitment rather than a dozen"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"unrelated ones. It holds the names the series is known by and the pattern its shifts"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"were generated from; the shifts themselves are read from the listing below."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"object"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" holds the stored values and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" the same values rendered for display."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"permissions"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" says what the caller may do with this series."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rules"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" describes the repeat the series was built on - "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"days"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" holds the days of the week"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"it covers, as integers with Sunday at "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"repeat"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" says whether the series is still"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"generating shifts, and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"end_date"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when it stops."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"event_id","in":"path","schemaId":"schema_419","description":"The ID of the event.","required":true},{"name":"id","in":"path","schemaId":"schema_421","description":"The ID of the shift link.","required":true}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1link~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1link~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/event/{event_id}/shift/link/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"event_id","in":"path","required":true,"schemaId":"schema_419"},{"name":"id","in":"path","required":true,"schemaId":"schema_421"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/v2/event/{event_id}/shift/link/{id}","href":"shift-module/readashiftlink","openApiOperationId":"readAShiftLink","summary":"Read a shift link"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_440"}},"schemaId":"schema_440"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1link~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_440","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_440"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/shift-module/readashiftlink"}],"panels":[]}]},"httpPath":"/api/v2/event/{event_id}/shift/link/{id}"},{"label":"Update a shift link","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/shift-module/updateashiftlink","routeSlug":"/api-docs/openapi/shift-module/updateashiftlink","metadata":{"seo":{"title":"Update a shift link","description":"Renames a shift link and returns it. Only the two names can be changed here - the repeatthe series was built on is fixed once its shifts exist, and the shifts themselves arechanged through the shift endpoints."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateAShiftLink","name":"Update a shift link","isWebhook":false,"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1link~1{id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a shift link","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Renames a shift link and returns it. Only the two names can be changed here - the repeat"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the series was built on is fixed once its shifts exist, and the shifts themselves are"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"changed through the shift endpoints."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Both fields are optional and an update carrying neither is accepted; send only what you"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"are changing. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" may be shortened or rewritten but not emptied - sending it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"or as more than 255 characters is a 422."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The link has to belong to the event in the URL; a mismatch is a 404."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"event_id","in":"path","schemaId":"schema_419","description":"The ID of the event.","required":true},{"name":"id","in":"path","schemaId":"schema_421","description":"The ID of the shift link.","required":true}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1link~1{id}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1link~1{id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_441"}},"schemaId":"schema_441","pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1link~1{id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v2/event/{event_id}/shift/link/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"event_id","in":"path","required":true,"schemaId":"schema_419"},{"name":"id","in":"path","required":true,"schemaId":"schema_421"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_441"}},"responseCodes":["200","404"],"pointer":"/api/v2/event/{event_id}/shift/link/{id}","href":"shift-module/updateashiftlink","openApiOperationId":"updateAShiftLink","summary":"Update a shift link"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_441","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_441"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_440"}},"schemaId":"schema_440"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1link~1{id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_440","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_440"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/shift-module/updateashiftlink"}],"panels":[]}]},"httpPath":"/api/v2/event/{event_id}/shift/link/{id}"},{"label":"Delete a shift link","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/shift-module/deleteashiftlink","routeSlug":"/api-docs/openapi/shift-module/deleteashiftlink","metadata":{"seo":{"title":"Delete a shift link","description":"Breaks up a series. The shifts that belonged to it are not deleted - they stay on theevent exactly as they were, and simply stop being part of a series, so anyone rosteredonto them keeps their place."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteAShiftLink","name":"Delete a shift link","isWebhook":false,"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1link~1{id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete a shift link","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Breaks up a series. The shifts that belonged to it are "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"not"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" deleted - they stay on the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"event exactly as they were, and simply stop being part of a series, so anyone rostered"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"onto them keeps their place."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This is a hard delete: the series cannot be restored, and rebuilding it means recreating"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the link and its shifts."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"event_id","in":"path","schemaId":"schema_419","description":"The ID of the event.","required":true},{"name":"id","in":"path","schemaId":"schema_421","description":"The ID of the shift link.","required":true}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1link~1{id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1link~1{id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/v2/event/{event_id}/shift/link/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"event_id","in":"path","required":true,"schemaId":"schema_419"},{"name":"id","in":"path","required":true,"schemaId":"schema_421"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["204","404"],"pointer":"/api/v2/event/{event_id}/shift/link/{id}","href":"shift-module/deleteashiftlink","openApiOperationId":"deleteAShiftLink","summary":"Delete a shift link"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_311"}},"schemaId":"schema_311"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1link~1{id}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"204","schemaId":"schema_311","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_311"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/shift-module/deleteashiftlink"}],"panels":[]}]},"httpPath":"/api/v2/event/{event_id}/shift/link/{id}"},{"label":"Check a shift before adding it to the cart","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/shift-module/checkashiftbeforeaddingittothecart","routeSlug":"/api-docs/openapi/shift-module/checkashiftbeforeaddingittothecart","metadata":{"seo":{"title":"Check a shift before adding it to the cart","description":"Asks whether you can take this shift, given the shifts already in your cart.Nothing is applied for and nothing is stored - this is the check the portal runs asa shift goes into the cart, so that a shift you cannot take is refused there ratherthan at the end."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"checkAShiftBeforeAddingItToTheCart","name":"Check a shift before adding it to the cart","isWebhook":false,"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1add-to-cart/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Check a shift before adding it to the cart","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Asks whether you can take this shift, given the shifts already in your cart."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Nothing is applied for and nothing is stored - this is the check the portal runs as"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"a shift goes into the cart, so that a shift you cannot take is refused there rather"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"than at the end."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A 200 with an empty body means yes. A refusal is a 422 whose "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"errors"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" names the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"shift and says why: the shift is full, its applications are not open, it clashes"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"with something else in the cart, or you already hold a place on it."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send the cart's other shifts in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cartItems"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" so clashes between them and this one"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"are caught. They are checked against this shift but are not themselves re-checked."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Applying for the shifts once the cart is settled is a separate call - see"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"apply to many shifts."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"event_id","in":"path","schemaId":"schema_419","description":"The ID of the event.","required":true},{"name":"shift_id","in":"path","schemaId":"schema_420","description":"The ID of the shift being added.","required":true}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1add-to-cart/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1add-to-cart/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_442"}},"schemaId":"schema_442","pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1add-to-cart/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/event/{event_id}/shift/{shift_id}/add-to-cart","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"event_id","in":"path","required":true,"schemaId":"schema_419"},{"name":"shift_id","in":"path","required":true,"schemaId":"schema_420"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_442"}},"responseCodes":["200","422"],"pointer":"/api/v2/event/{event_id}/shift/{shift_id}/add-to-cart","href":"shift-module/checkashiftbeforeaddingittothecart","openApiOperationId":"checkAShiftBeforeAddingItToTheCart","summary":"Check a shift before adding it to the cart"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_442","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_442"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_311"}},"schemaId":"schema_311"},{"code":"422","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_433"}},"schemaId":"schema_433"}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1add-to-cart/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_311","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_311"}}},{"code":"422","schemaId":"schema_433","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_433"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/shift-module/checkashiftbeforeaddingittothecart"}],"panels":[]}]},"httpPath":"/api/v2/event/{event_id}/shift/{shift_id}/add-to-cart"},{"label":"Cancel a shift","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/shift-module/cancelashift","routeSlug":"/api-docs/openapi/shift-module/cancelashift","metadata":{"seo":{"title":"Cancel a shift","description":"Calls the shift off. It is marked as cancelled, it stops being published, andeveryone holding a place on it is moved to a cancelled status - which is whattriggers whatever your account has set up to tell them."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"cancelAShift","name":"Cancel a shift","isWebhook":false,"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1cancel/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Cancel a shift","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Calls the shift off. It is marked as cancelled, it stops being published, and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"everyone holding a place on it is moved to a cancelled status - which is what"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"triggers whatever your account has set up to tell them."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The work is queued and the response is a token for the queued job, so "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"nothing has"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"changed by the time it comes back"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The token is not something you can poll; read"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the shift back to confirm. "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This is a GET that changes things"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", which is unusual"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"for this API and worth knowing before you put it behind a link or a prefetch."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A shift can only be cancelled while it is published, has not started and is not"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"already cancelled; otherwise the call is a 404. Cancelling is not deleting - the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"shift stays, and it can be un-cancelled afterwards."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"event_id","in":"path","schemaId":"schema_419","description":"The ID of the event.","required":true},{"name":"shift_id","in":"path","schemaId":"schema_420","description":"The ID of the shift to cancel.","required":true}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1cancel/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1cancel/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/event/{event_id}/shift/{shift_id}/cancel","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"event_id","in":"path","required":true,"schemaId":"schema_419"},{"name":"shift_id","in":"path","required":true,"schemaId":"schema_420"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/event/{event_id}/shift/{shift_id}/cancel","href":"shift-module/cancelashift","openApiOperationId":"cancelAShift","summary":"Cancel a shift"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_443"}},"schemaId":"schema_443"}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{shift_id}~1cancel/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_443","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_443"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/shift-module/cancelashift"}],"panels":[]}]},"httpPath":"/api/v2/event/{event_id}/shift/{shift_id}/cancel"},{"label":"Update many shifts at once","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/shift-module/updatemanyshiftsatonce","routeSlug":"/api-docs/openapi/shift-module/updatemanyshiftsatonce","metadata":{"seo":{"title":"Update many shifts at once","description":"Queues the work of applying one set of changes to many shifts and returns a tokenfor the queued job. Nothing has changed by the time the response comes back,and the token is not something you can poll - read the shifts back to confirm."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateManyShiftsAtOnce","name":"Update many shifts at once","isWebhook":false,"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update many shifts at once","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Queues the work of applying one set of changes to many shifts and returns a token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"for the queued job. "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Nothing has changed by the time the response comes back"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":","},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and the token is not something you can poll - read the shifts back to confirm."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Choose the shifts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"applyTo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" acts on the ids in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":","},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"anything else acts on every shift in the event, narrowed by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filter"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if one is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"sent. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"applyTo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is required and a request without it is a 422."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Every other field is a value to set on each shift, and takes the same shapes as on"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"a single update. Two suffixes change how a field is treated: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"<field>:use_default"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"as true drops that field from the update and leaves each shift's own value alone,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"<field>:override"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" as true replaces a value a shift's template locks, for a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"caller allowed to override locked fields. Shifts the caller cannot update are"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"skipped, as are shifts whose own validation refuses the change; neither is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"reported back."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint also accepts file uploads"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", for the fields that hold one - send"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the request as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"multipart/form-data"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with the file under the field's own name and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the rest of the fields alongside it, and the field is set to the URL the file was"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"stored at. The body is documented as JSON below because an operation carries one"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"content type and JSON is the common case; the multipart form takes the same fields."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"event_id","in":"path","schemaId":"schema_419","description":"The ID of the event.","required":true}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_444"}},"schemaId":"schema_444","pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v2/event/{event_id}/shift","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"event_id","in":"path","required":true,"schemaId":"schema_419"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_444"}},"responseCodes":["200"],"pointer":"/api/v2/event/{event_id}/shift","href":"shift-module/updatemanyshiftsatonce","openApiOperationId":"updateManyShiftsAtOnce","summary":"Update many shifts at once"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_444","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_444"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_445"}},"schemaId":"schema_445"}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_445","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_445"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/shift-module/updatemanyshiftsatonce"}],"panels":[]}]},"httpPath":"/api/v2/event/{event_id}/shift"},{"label":"List an event's shifts","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/shift-module/listaneventsshifts","routeSlug":"/api-docs/openapi/shift-module/listaneventsshifts","metadata":{"seo":{"title":"List an event's shifts","description":"Returns the shifts belonging to one event, with the demand figures for each andwhat the caller is allowed to do with it."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listAnEventsShifts","name":"List an event's shifts","isWebhook":false,"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List an event's shifts","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the shifts belonging to one event, with the demand figures for each and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"what the caller is allowed to do with it."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A shift is a block of time on an event that people are rostered onto. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"min_demand"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"max_demand"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are how many people it needs and how many it can take,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"leader_demand"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" how many of those places are for leaders. The rows carry those"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"figures and the shift's own settings; they carry nobody's name. To see who is on a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"shift, read its assignments."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response is only wrapped in a paginated envelope when a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"sent. Without one, every match comes back as a flat array. The envelope carries no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"total"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and no "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"last_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - page until "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next_page_url"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is null rather than"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"counting pages up front."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This listing can be read without signing in"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and it is the only endpoint in"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"this group that can. Without a token it returns the published, public shifts of a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"public, published event and nothing else; a signed-in caller who cannot read"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"shifts gets the same narrowing."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"event_id","in":"path","schemaId":"schema_419","description":"The ID of the event.","required":true}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"applied","in":"query","schemaId":"schema_446","description":"Keep only shifts the signed-in person has applied for."},{"name":"accepted","in":"query","schemaId":"schema_447","description":"Keep only shifts the signed-in person holds a place on."},{"name":"leader","in":"query","schemaId":"schema_448","description":"Keep only shifts the signed-in person leads."},{"name":"notOnShift","in":"query","schemaId":"schema_449","description":"Keep only shifts the signed-in person is not already\non. Named in camelCase because that is what the endpoint reads."},{"name":"noLinkedShifts","in":"query","schemaId":"schema_450","description":"Keep only shifts that do not belong to a linked\nseries. Named in camelCase because that is what the endpoint reads."},{"name":"eventEoi","in":"query","schemaId":"schema_451","description":"Keep only shifts on events the signed-in person has\nregistered interest in. Named in camelCase because that is what the endpoint reads."},{"name":"intentToSwap","in":"query","schemaId":"schema_452","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Work out each shift's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"permissions.apply"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" as though"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the person were swapping out of a shift they already hold, rather than taking an"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"extra one. Named in camelCase because that is what the endpoint reads."},"children":[]}]}]}]},{"name":"currentId","in":"query","schemaId":"schema_453","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The shift being swapped out of, used with"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"intentToSwap"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Named in camelCase because that is what the endpoint reads."},"children":[]}]}]}]},{"name":"per_page","in":"query","schemaId":"schema_262","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of results to return per page. The higher the number the longer the request may take."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is highly recommended to use this to avoid timeouts as your data grows."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate results."},"children":[]}]}]}]},{"name":"page","in":"query","schemaId":"schema_263","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The page of results to return. Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"per_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"results. If not specified, defaults to 1."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response's next_page_url will be null if there are no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"more pages."},"children":[]}]}]}]},{"name":"filter","in":"query","schemaId":"schema_264","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A filter to apply to the results. Declared as an array of objects, where each object"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contains an attr (attribute code), operator and value key. Examples:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=name&filter[0][operator]=like&filter[0][value]=luke"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=id&filter[0][operator]=>&filter[0][value]=265"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the filters documentation for more details on how to use this."},"children":[]}]}]}],"example":null},{"name":"sort_by","in":"query","schemaId":"schema_265","description":"The field to sort the results by. No ordering is applied unless you specify one, so\nrow order is not guaranteed. Always send it when paging through a list, otherwise\nrecords can repeat or be missed between pages.\nExample: id","example":null},{"name":"sort_order","in":"query","schemaId":"schema_266","description":"The direction to sort the results by. Can be 'asc' or 'desc', default is 'asc'.","example":null},{"name":"_locale","in":"query","schemaId":"schema_267","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The locale to use for the response. This primarily affects the results of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contain human-readable labels and terms, as well as locale-specific date formats.,"},"children":[]}]}]}]},{"name":"extras","in":"query","schemaId":"schema_437","description":"A list of extras to include in the response. These are objects or arrays that are not part of\nthe model's primary attributes, such as stats and counts.\nFor fast responses, avoid requesting them if you don't need them. "},{"name":"with","in":"query","schemaId":"schema_438","description":"A list of relations to include in the response. May be single records or collections.\nIt is often more efficient to retrieve this way, to avoid follow-up API calls."}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/event/{event_id}/shift","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"event_id","in":"path","required":true,"schemaId":"schema_419"}],"query":[{"name":"applied","in":"query","required":false,"schemaId":"schema_446"},{"name":"accepted","in":"query","required":false,"schemaId":"schema_447"},{"name":"leader","in":"query","required":false,"schemaId":"schema_448"},{"name":"notOnShift","in":"query","required":false,"schemaId":"schema_449"},{"name":"noLinkedShifts","in":"query","required":false,"schemaId":"schema_450"},{"name":"eventEoi","in":"query","required":false,"schemaId":"schema_451"},{"name":"intentToSwap","in":"query","required":false,"schemaId":"schema_452"},{"name":"currentId","in":"query","required":false,"schemaId":"schema_453"},{"name":"per_page","in":"query","required":false,"schemaId":"schema_262"},{"name":"page","in":"query","required":false,"schemaId":"schema_263"},{"name":"filter","in":"query","required":false,"schemaId":"schema_264"},{"name":"sort_by","in":"query","required":false,"schemaId":"schema_265"},{"name":"sort_order","in":"query","required":false,"schemaId":"schema_266"},{"name":"_locale","in":"query","required":false,"schemaId":"schema_267"},{"name":"extras","in":"query","required":false,"schemaId":"schema_437"},{"name":"with","in":"query","required":false,"schemaId":"schema_438"}],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/event/{event_id}/shift","href":"shift-module/listaneventsshifts","openApiOperationId":"listAnEventsShifts","summary":"List an event's shifts"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_454"}},"schemaId":"schema_454"}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_454","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_454"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/shift-module/listaneventsshifts"}],"panels":[]}]},"httpPath":"/api/v2/event/{event_id}/shift"},{"label":"Create a shift","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/shift-module/createashift","routeSlug":"/api-docs/openapi/shift-module/createashift","metadata":{"seo":{"title":"Create a shift","description":"Adds a shift to an event and returns it. The created shift carries only the fieldsthe create set, so it is a smaller object than the one a read returns - read itback if you need the whole record."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createAShift","name":"Create a shift","isWebhook":false,"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a shift","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Adds a shift to an event and returns it. The created shift carries only the fields"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the create set, so it is a smaller object than the one a read returns - read it"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"back if you need the whole record."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A full create is a long body: a shift needs times, demand figures, a location and a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"status for each point of its lifecycle. "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"all_default"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to avoid most of it"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" -"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the shift is then filled in from the event it belongs to, and anything you send"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"explicitly still wins. Without it, a create missing any required field is a 422"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"naming the fields."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sending "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"event_shift_template_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" builds the shift from a template, and the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"template's values replace what you send for the fields it defines."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Any attribute your account has configured for a shift is accepted here alongside"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the fields below, under the code you gave it."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"event_id","in":"path","schemaId":"schema_419","description":"The ID of the event.","required":true}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_455"}},"schemaId":"schema_455","pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/event/{event_id}/shift","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"event_id","in":"path","required":true,"schemaId":"schema_419"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_455"}},"responseCodes":["201","404"],"pointer":"/api/v2/event/{event_id}/shift","href":"shift-module/createashift","openApiOperationId":"createAShift","summary":"Create a shift"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_455","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_455"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_456"}},"schemaId":"schema_456"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_456","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_456"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/shift-module/createashift"}],"panels":[]}]},"httpPath":"/api/v2/event/{event_id}/shift"},{"label":"Read a shift","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/shift-module/readashift","routeSlug":"/api-docs/openapi/shift-module/readashift","metadata":{"seo":{"title":"Read a shift","description":"Returns one shift with its times, demand figures, location and the settings thatgovern applying, checking in and checking out."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"readAShift","name":"Read a shift","isWebhook":false,"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Read a shift","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns one shift with its times, demand figures, location and the settings that"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"govern applying, checking in and checking out."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"object"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" holds the stored values and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" the same values rendered for display -"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"dates formatted in the shift's timezone, ids resolved to the names they point at."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"permissions"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" says what the caller may do with this shift, and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"apply_error"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" says"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"why applying is refused when it is."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The shift has to belong to the event in the URL; a mismatch is a 404."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"event_id","in":"path","schemaId":"schema_419","description":"The ID of the event.","required":true},{"name":"id","in":"path","schemaId":"schema_420","description":"The ID of the shift.","required":true}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/event/{event_id}/shift/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"event_id","in":"path","required":true,"schemaId":"schema_419"},{"name":"id","in":"path","required":true,"schemaId":"schema_420"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/v2/event/{event_id}/shift/{id}","href":"shift-module/readashift","openApiOperationId":"readAShift","summary":"Read a shift"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_457"}},"schemaId":"schema_457"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_457","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_457"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/shift-module/readashift"}],"panels":[]}]},"httpPath":"/api/v2/event/{event_id}/shift/{id}"},{"label":"Update a shift","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/shift-module/updateashift","routeSlug":"/api-docs/openapi/shift-module/updateashift","metadata":{"seo":{"title":"Update a shift","description":"Changes one shift and returns it. Every field is optional; send only what you arechanging."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateAShift","name":"Update a shift","isWebhook":false,"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a shift","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Changes one shift and returns it. Every field is optional; send only what you are"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"changing."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A shift in a linked series cannot be updated without saying what to do about the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"rest of the series."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" The first attempt comes back as a 400 carrying"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reference: \"_options.update_linked_shifts\""},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - a prompt rather than an error."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Answer it by sending "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"_options.update_linked_shifts"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": false changes this shift"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"alone and returns it, true also changes the shifts linked to it, and "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"that form"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{\"queue\": \"<token>\"}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instead of the shift"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", because the rest of the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"series is changed in the background. The token is not something you can poll; read"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the shifts back to confirm."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Where the shift was built from a template, the template's values replace what you"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"send for the fields it locks, unless you also send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"<field>:override"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" as true and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"are allowed to override locked fields."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Any attribute your account has configured for a shift is accepted here alongside"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the fields below, under the code you gave it. The shift has to belong to the event"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"in the URL; a mismatch is a 404."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"event_id","in":"path","schemaId":"schema_419","description":"The ID of the event.","required":true},{"name":"id","in":"path","schemaId":"schema_420","description":"The ID of the shift.","required":true}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{id}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_458"}},"schemaId":"schema_458","pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v2/event/{event_id}/shift/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"event_id","in":"path","required":true,"schemaId":"schema_419"},{"name":"id","in":"path","required":true,"schemaId":"schema_420"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_458"}},"responseCodes":["200","400","404"],"pointer":"/api/v2/event/{event_id}/shift/{id}","href":"shift-module/updateashift","openApiOperationId":"updateAShift","summary":"Update a shift"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_458","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_458"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_459"}},"schemaId":"schema_459"},{"code":"400","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_460"}},"schemaId":"schema_460"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_459","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_459"}}},{"code":"400","schemaId":"schema_460","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_460"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/shift-module/updateashift"}],"panels":[]}]},"httpPath":"/api/v2/event/{event_id}/shift/{id}"},{"label":"Delete a shift","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/shift-module/deleteashift","routeSlug":"/api-docs/openapi/shift-module/deleteashift","metadata":{"seo":{"title":"Delete a shift","description":"Removes a shift from the event."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteAShift","name":"Delete a shift","isWebhook":false,"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{id}/delete","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete a shift","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Removes a shift from the event."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This returns a 200 carrying "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{\"messages\": null}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", not the 204 the rest of the API"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"returns for a delete."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"messages"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is normally null and carries a note when"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"something about the deletion is worth telling the caller."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Two things can interrupt it, and both are questions rather than failures."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A shift in a linked series comes back as a 400 carrying "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reference: \"repeat\""},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":","},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"which you answer by sending "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"repeat"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": true also deletes every later shift in the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"series and drops the people following it, false deletes this shift alone."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A shift people already hold places on comes back as a 405 saying how many they are"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and carrying the key to confirm with in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reference"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Send that key back "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"in the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"query string, as an array"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", keeping the rest of the request the same:"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"?override[]=event.shift.delete.demand"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Two things to know about it. The key in"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reference"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is prefixed - send the part after "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"override_system_limits."},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", not the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"whole string. And it has to be the array form: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"?override=event.shift.delete.demand"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"is a 500, and sending it in the JSON body is not seen at all and simply repeats the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"405."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The shift has to belong to the event in the URL; a mismatch is a 404."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"event_id","in":"path","schemaId":"schema_419","description":"The ID of the event.","required":true},{"name":"id","in":"path","schemaId":"schema_420","description":"The ID of the shift.","required":true}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{id}/delete/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_461"}},"schemaId":"schema_461","pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{id}/delete/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/v2/event/{event_id}/shift/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"event_id","in":"path","required":true,"schemaId":"schema_419"},{"name":"id","in":"path","required":true,"schemaId":"schema_420"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_461"}},"responseCodes":["200","400","404","405"],"pointer":"/api/v2/event/{event_id}/shift/{id}","href":"shift-module/deleteashift","openApiOperationId":"deleteAShift","summary":"Delete a shift"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_461","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_461"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_337"}},"schemaId":"schema_337"},{"code":"400","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_462"}},"schemaId":"schema_462"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"},{"code":"405","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_463"}},"schemaId":"schema_463"}],"pointer":"/paths/~1api~1v2~1event~1{event_id}~1shift~1{id}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_337","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_337"}}},{"code":"400","schemaId":"schema_462","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_462"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}},{"code":"405","schemaId":"schema_463","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_463"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/shift-module/deleteashift"}],"panels":[]}]},"httpPath":"/api/v2/event/{event_id}/shift/{id}"}],"content":{"contentType":"group","meta":{"name":"Shift Module"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Shift Module","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v2/event/{event_id}/shift/{shift_id}/user","summary":"List shift assignments","prefix":{"name":"get","color":"get"},"badges":[],"link":"/shift-module/listshiftassignments","deprecated":false},{"title":"/api/v2/event/{event_id}/shift/{shift_id}/user","summary":"Put a person on a shift","prefix":{"name":"post","color":"post"},"badges":[],"link":"/shift-module/putapersononashift","deprecated":false},{"title":"/api/v2/event/{event_id}/shift/{shift_id}/user/{id}","summary":"Read a shift assignment","prefix":{"name":"get","color":"get"},"badges":[],"link":"/shift-module/readashiftassignment","deprecated":false},{"title":"/api/v2/event/{event_id}/shift/{shift_id}/user/{id}","summary":"Update a shift assignment","prefix":{"name":"put","color":"put"},"badges":[],"link":"/shift-module/updateashiftassignment","deprecated":false},{"title":"/api/v2/event/{event_id}/shift/{shift_id}/user/{id}","summary":"Take a person off a shift","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/shift-module/takeapersonoffashift","deprecated":false},{"title":"/api/v2/event/shift/user","summary":"List shift assignments","prefix":{"name":"get","color":"get"},"badges":[],"link":"/shift-module/listallshiftassignments","deprecated":false},{"title":"/api/v2/event/{event_id}/shift/{shift_id}/user/mass-create","summary":"Add many people to a shift","prefix":{"name":"post","color":"post"},"badges":[],"link":"/shift-module/addmanypeopletoashift","deprecated":false},{"title":"/api/v2/event/{event_id}/shift/user/mass-create","summary":"Add many people to a shift","prefix":{"name":"post","color":"post"},"badges":[],"link":"/shift-module/addmanypeopletoashiftbyquery","deprecated":false},{"title":"/api/v2/event/shift/user/mass-delete","summary":"Remove many people from shifts","prefix":{"name":"post","color":"post"},"badges":[],"link":"/shift-module/removemanypeoplefromshifts","deprecated":false},{"title":"/api/v2/event/shift/apply-all","summary":"Apply for several shifts at once","prefix":{"name":"post","color":"post"},"badges":[],"link":"/shift-module/applyforseveralshiftsatonce","deprecated":false},{"title":"/api/v2/event/shift/{shift_id}/submit-application","summary":"Check a shift's application form","prefix":{"name":"post","color":"post"},"badges":[],"link":"/shift-module/checkashiftsapplicationform","deprecated":false},{"title":"/api/v2/event/{event_id}/shift/link/{link_id}/shift","summary":"List the shifts in a series","prefix":{"name":"get","color":"get"},"badges":[],"link":"/shift-module/listtheshiftsinaseries","deprecated":false},{"title":"/api/v2/event/{event_id}/shift/link/{id}","summary":"Read a shift link","prefix":{"name":"get","color":"get"},"badges":[],"link":"/shift-module/readashiftlink","deprecated":false},{"title":"/api/v2/event/{event_id}/shift/link/{id}","summary":"Update a shift link","prefix":{"name":"put","color":"put"},"badges":[],"link":"/shift-module/updateashiftlink","deprecated":false},{"title":"/api/v2/event/{event_id}/shift/link/{id}","summary":"Delete a shift link","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/shift-module/deleteashiftlink","deprecated":false},{"title":"/api/v2/event/{event_id}/shift/{shift_id}/add-to-cart","summary":"Check a shift before adding it to the cart","prefix":{"name":"post","color":"post"},"badges":[],"link":"/shift-module/checkashiftbeforeaddingittothecart","deprecated":false},{"title":"/api/v2/event/{event_id}/shift/{shift_id}/cancel","summary":"Cancel a shift","prefix":{"name":"get","color":"get"},"badges":[],"link":"/shift-module/cancelashift","deprecated":false},{"title":"/api/v2/event/{event_id}/shift","summary":"Update many shifts at once","prefix":{"name":"put","color":"put"},"badges":[],"link":"/shift-module/updatemanyshiftsatonce","deprecated":false},{"title":"/api/v2/event/{event_id}/shift","summary":"List an event's shifts","prefix":{"name":"get","color":"get"},"badges":[],"link":"/shift-module/listaneventsshifts","deprecated":false},{"title":"/api/v2/event/{event_id}/shift","summary":"Create a shift","prefix":{"name":"post","color":"post"},"badges":[],"link":"/shift-module/createashift","deprecated":false},{"title":"/api/v2/event/{event_id}/shift/{id}","summary":"Read a shift","prefix":{"name":"get","color":"get"},"badges":[],"link":"/shift-module/readashift","deprecated":false},{"title":"/api/v2/event/{event_id}/shift/{id}","summary":"Update a shift","prefix":{"name":"put","color":"put"},"badges":[],"link":"/shift-module/updateashift","deprecated":false},{"title":"/api/v2/event/{event_id}/shift/{id}","summary":"Delete a shift","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/shift-module/deleteashift","deprecated":false}]}]}]}]}},{"type":"group","label":"Reward Point","link":"/api-docs/openapi/reward-point","routeSlug":"/api-docs/openapi/reward-point","items":[{"label":"Read a reward point balance","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/reward-point/readarewardpointbalance","routeSlug":"/api-docs/openapi/reward-point/readarewardpointbalance","metadata":{"seo":{"title":"Read a reward point balance","description":"Returns one user's reward point balance: how many points they hold now, andwho they belong to."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"readARewardPointBalance","name":"Read a reward point balance","isWebhook":false,"pointer":"/paths/~1api~1v2~1reward-point~1user~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Read a reward point balance","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns one user's reward point balance: how many points they hold now, and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"who they belong to."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The record is the running total only. It does not carry the transactions that"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"produced it, and there is no history in this response - read the reward point"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"transactions for that."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID in the URL is the balance record's own ID, not the user's. To go from a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"user to their balance, list the balances and filter on "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"permissions"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" always reports update and delete as unavailable: a balance is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"derived from the transactions recorded against it and is not writable through"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the API."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the reward point balance record.","required":true}],"pointer":"/paths/~1api~1v2~1reward-point~1user~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1reward-point~1user~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/reward-point/user/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/v2/reward-point/user/{id}","href":"reward-point/readarewardpointbalance","openApiOperationId":"readARewardPointBalance","summary":"Read a reward point balance"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_464"}},"schemaId":"schema_464"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1reward-point~1user~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_464","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_464"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/reward-point/readarewardpointbalance"}],"panels":[]}]},"httpPath":"/api/v2/reward-point/user/{id}"}],"content":{"contentType":"group","meta":{"name":"Reward Point"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Reward Point","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v2/reward-point/user/{id}","summary":"Read a reward point balance","prefix":{"name":"get","color":"get"},"badges":[],"link":"/reward-point/readarewardpointbalance","deprecated":false}]}]}]}]}},{"type":"group","label":"Automatic Rostering","link":"/api-docs/openapi/automatic-rostering","routeSlug":"/api-docs/openapi/automatic-rostering","items":[{"label":"Roster people onto shifts","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/automatic-rostering/rosterpeopleontoshifts","routeSlug":"/api-docs/openapi/automatic-rostering/rosterpeopleontoshifts","metadata":{"seo":{"title":"Roster people onto shifts","description":"Fills a set of an event's shifts from a pool of people - a user group, theaccepted applicants of a role offer, or an uploaded file - creating a shiftapplication for each person placed."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"rosterPeopleOntoShifts","name":"Roster people onto shifts","isWebhook":false,"pointer":"/paths/~1api~1v2~1automatic-rostering~1event-shift/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Roster people onto shifts","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fills a set of an event's shifts from a pool of people - a user group, the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"accepted applicants of a role offer, or an uploaded file - creating a shift"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"application for each person placed."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This write is queued, and the response carries no way to follow it."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" A 200"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"means the request passed validation and the work was handed off, nothing more."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The body is a fixed confirmation message with no identifier in it, so there is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"no request to poll and no way to be told when the rostering has finished or"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"what it did. Confirm the outcome by listing the event's shift applications and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"looking for the new rows. Do not treat the response as meaning anyone has been"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"rostered."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Choose the shifts either way round:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"applyTo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" holding the shift IDs to fill."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send any other "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"applyTo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" value to fill every shift on the event the caller can"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"see, narrowed by an optional "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filter"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Then choose the people with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and supply whichever field that source"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"needs: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"group_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"group"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"role_offer_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"role_offer"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"file"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"import"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" that is none of those three is accepted and rosters nobody."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How many people go onto each shift is decided by that shift's own demand, so a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"shift that is already full takes nobody. Running the same request twice is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"therefore close to safe, though it will consider the same people again unless"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bypass_scheduled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is set."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Invalid input returns a 422 before anything is queued."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note that "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"applyTo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is spelled in camelCase, unlike every other parameter on"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"this endpoint."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1automatic-rostering~1event-shift/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_465"}},"schemaId":"schema_465","pointer":"/paths/~1api~1v2~1automatic-rostering~1event-shift/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v2/automatic-rostering/event-shift","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_465"}},"responseCodes":["200"],"pointer":"/api/v2/automatic-rostering/event-shift","href":"automatic-rostering/rosterpeopleontoshifts","openApiOperationId":"rosterPeopleOntoShifts","summary":"Roster people onto shifts"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_465","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_465"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_466"}},"schemaId":"schema_466"}],"pointer":"/paths/~1api~1v2~1automatic-rostering~1event-shift/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_466","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_466"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/automatic-rostering/rosterpeopleontoshifts"}],"panels":[]}]},"httpPath":"/api/v2/automatic-rostering/event-shift"}],"content":{"contentType":"group","meta":{"name":"Automatic Rostering"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Automatic Rostering","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v2/automatic-rostering/event-shift","summary":"Roster people onto shifts","prefix":{"name":"put","color":"put"},"badges":[],"link":"/automatic-rostering/rosterpeopleontoshifts","deprecated":false}]}]}]}]}},{"type":"group","label":"Utilities","link":"/api-docs/openapi/utilities","routeSlug":"/api-docs/openapi/utilities","items":[{"label":"Read an option set","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/utilities/readanoptionset","routeSlug":"/api-docs/openapi/utilities/readanoptionset","metadata":{"seo":{"title":"Read an option set","description":"Returns the values a given field accepts, as a flat list of value and textpairs. value is what you send back on a write; text is the label the samething is shown under in the console. Use this instead of hard-coding IDs, whichdiffer from one account to the next."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"readAnOptionSet","name":"Read an option set","isWebhook":false,"pointer":"/paths/~1api~1v2~1helpers~1source~1{module}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Read an option set","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the values a given field accepts, as a flat list of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"value"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"text"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"pairs. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"value"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is what you send back on a write; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"text"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the label the same"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"thing is shown under in the console. Use this instead of hard-coding IDs, which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"differ from one account to the next."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The list is not paginated and carries no envelope - the whole set comes back in"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"one array, ordered as the option set defines."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The set named in the URL decides what you get. Common ones are:"},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Option set"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Values for"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"event_type"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An event's type"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"event_template"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The template an event can be created from"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"event_shift_status"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A shift application's status"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"event_shift_type"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A shift's type"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"event_shift_status_type"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The category a shift status belongs to"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"shift_template"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The template a shift can be created from"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user_type"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A user's type"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user_group"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user_group_type"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A user's group, and the group's type"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user_checkpoint"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user_checkpoint_type"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A user's checkpoint, and its type"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"training_type"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A training module's type"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"form_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"form_category"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A form's type and category"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"report_category"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A report's category"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"blog_article_type"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An article's type"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"item_category"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An inventory item's category"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"headcount_functionalarea"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A functional area"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"headcount_functionalarea_type"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A functional area's type"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"headcount_functionalarea_job_title"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A job title within a functional area"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"headcount_location"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"headcount_location_type"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A location and its type"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"headcount_location_venue"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A venue within a location"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"headcount_journey"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A journey"},"children":[]}]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Further sets exist beyond this list, and which of them a caller can read depends"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"on the permissions that caller holds."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A few sets are narrowed by a further value - "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"headcount_location_venue"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" by"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"headcount_location_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", for instance, and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"headcount_functionalarea_job_title"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"headcount_functional_area_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Send that value as a query parameter. Where"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the narrowing value is mandatory and is missing, the response is an empty array"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"rather than an error."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"module","in":"path","schemaId":"schema_467","description":"The option set to read.","required":true}],"pointer":"/paths/~1api~1v2~1helpers~1source~1{module}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"assoc","in":"query","schemaId":"schema_468","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to keep any extra keys an option set carries beyond value"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and text, such as the group a shift status belongs to. Defaults to 1, which returns value"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and text only."},"children":[]}]}]}]},{"name":"active","in":"query","schemaId":"schema_469","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to limit the list to options that are currently in use."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Not every option set distinguishes active options, and those that do not return the full"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"list either way."},"children":[]}]}]}]},{"name":"filter","in":"query","schemaId":"schema_470","description":"Narrows the list, in the same form the listing endpoints accept.\n  Only option sets backed by a record type support it; the rest ignore it.","example":null}],"pointer":"/paths/~1api~1v2~1helpers~1source~1{module}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1helpers~1source~1{module}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/helpers/source/{module}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"module","in":"path","required":true,"schemaId":"schema_467"}],"query":[{"name":"assoc","in":"query","required":false,"schemaId":"schema_468"},{"name":"active","in":"query","required":false,"schemaId":"schema_469"},{"name":"filter","in":"query","required":false,"schemaId":"schema_470"}],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/helpers/source/{module}","href":"utilities/readanoptionset","openApiOperationId":"readAnOptionSet","summary":"Read an option set"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_471"}},"schemaId":"schema_471"}],"pointer":"/paths/~1api~1v2~1helpers~1source~1{module}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_471","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_471"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/utilities/readanoptionset"}],"panels":[]}]},"httpPath":"/api/v2/helpers/source/{module}"}],"content":{"contentType":"group","meta":{"name":"Utilities"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Utilities","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v2/helpers/source/{module}","summary":"Read an option set","prefix":{"name":"get","color":"get"},"badges":[],"link":"/utilities/readanoptionset","deprecated":false}]}]}]}]}},{"type":"group","label":"Form Module","link":"/api-docs/openapi/form-module","routeSlug":"/api-docs/openapi/form-module","items":[{"label":"List forms","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/form-module/listforms","routeSlug":"/api-docs/openapi/form-module/listforms","metadata":{"seo":{"title":"List forms","description":"Returns the forms in the account you are calling as, together with the forms itinherits from the accounts above it."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listForms","name":"List forms","isWebhook":false,"pointer":"/paths/~1api~1v2~1form/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List forms","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the forms in the account you are calling as, together with the forms it"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"inherits from the accounts above it."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This is an administration endpoint. It answers only for callers who may read"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"forms and who are calling as the admin console; for anyone else it answers as"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"though it does not exist. A caller who only needs to fill a form in should read"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"it through "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /form/{id}/view"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instead, or through the endpoint of whatever the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"form is attached to."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"is_submissions_listing"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"is_admin_submissions_listing"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" narrow the result to"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the forms behind the two submission listings, and are mutually exclusive - if"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"both are sent, the admin one wins."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"is_submissions_listing","in":"query","schemaId":"schema_472","description":"Return only forms whose submissions are\n  collected from the people filling them in, excluding admin submission forms."},{"name":"is_admin_submissions_listing","in":"query","schemaId":"schema_473","description":"Return only admin submission\n  forms - the ones an administrator completes about somebody else."},{"name":"report_type_id","in":"query","schemaId":"schema_474","description":"Narrow the result to the forms a report of this\n  type can be built from."},{"name":"per_page","in":"query","schemaId":"schema_262","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of results to return per page. The higher the number the longer the request may take."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is highly recommended to use this to avoid timeouts as your data grows."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate results."},"children":[]}]}]}]},{"name":"page","in":"query","schemaId":"schema_263","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The page of results to return. Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"per_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"results. If not specified, defaults to 1."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response's next_page_url will be null if there are no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"more pages."},"children":[]}]}]}]},{"name":"filter","in":"query","schemaId":"schema_264","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A filter to apply to the results. Declared as an array of objects, where each object"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contains an attr (attribute code), operator and value key. Examples:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=name&filter[0][operator]=like&filter[0][value]=luke"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=id&filter[0][operator]=>&filter[0][value]=265"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the filters documentation for more details on how to use this."},"children":[]}]}]}],"example":null},{"name":"sort_by","in":"query","schemaId":"schema_265","description":"The field to sort the results by. No ordering is applied unless you specify one, so\nrow order is not guaranteed. Always send it when paging through a list, otherwise\nrecords can repeat or be missed between pages.\nExample: id","example":null},{"name":"sort_order","in":"query","schemaId":"schema_266","description":"The direction to sort the results by. Can be 'asc' or 'desc', default is 'asc'.","example":null},{"name":"_locale","in":"query","schemaId":"schema_267","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The locale to use for the response. This primarily affects the results of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contain human-readable labels and terms, as well as locale-specific date formats.,"},"children":[]}]}]}]}],"pointer":"/paths/~1api~1v2~1form/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1form/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/form","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[{"name":"is_submissions_listing","in":"query","required":false,"schemaId":"schema_472"},{"name":"is_admin_submissions_listing","in":"query","required":false,"schemaId":"schema_473"},{"name":"report_type_id","in":"query","required":false,"schemaId":"schema_474"},{"name":"per_page","in":"query","required":false,"schemaId":"schema_262"},{"name":"page","in":"query","required":false,"schemaId":"schema_263"},{"name":"filter","in":"query","required":false,"schemaId":"schema_264"},{"name":"sort_by","in":"query","required":false,"schemaId":"schema_265"},{"name":"sort_order","in":"query","required":false,"schemaId":"schema_266"},{"name":"_locale","in":"query","required":false,"schemaId":"schema_267"}],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/form","href":"form-module/listforms","openApiOperationId":"listForms","summary":"List forms"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_475"}},"schemaId":"schema_475"}],"pointer":"/paths/~1api~1v2~1form/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_475","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_475"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/form-module/listforms"}],"panels":[]}]},"httpPath":"/api/v2/form"},{"label":"Create a form","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/form-module/createaform","routeSlug":"/api-docs/openapi/form-module/createaform","metadata":{"seo":{"title":"Create a form","description":"Creates an empty form in the account you are calling as. The response is thecreated form, carrying only the fields the create set - read it back withGET /form/{id} for the full shape."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createAForm","name":"Create a form","isWebhook":false,"pointer":"/paths/~1api~1v2~1form/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a form","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Creates an empty form in the account you are calling as. The response is the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"created form, carrying only the fields the create set - read it back with"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /form/{id}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for the full shape."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A form is created with no fields. Add them through the field resource beneath it"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"before publishing it, or send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"_options[from_template]"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to build it from one of"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the account's form templates, which copies the template's name and type and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"saves you sending either."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"form_type_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" cannot be changed afterwards, so it is worth getting right: it"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"decides what submitting the form does. Sub-account registration forms"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"additionally require "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"options[account_type_id]"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1form/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_476"}},"schemaId":"schema_476","pointer":"/paths/~1api~1v2~1form/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/form","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_476"}},"responseCodes":["200","404"],"pointer":"/api/v2/form","href":"form-module/createaform","openApiOperationId":"createAForm","summary":"Create a form"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_476","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_476"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_477"}},"schemaId":"schema_477"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1form/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_477","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_477"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/form-module/createaform"}],"panels":[]}]},"httpPath":"/api/v2/form"},{"label":"Update a form","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/form-module/updateaform","routeSlug":"/api-docs/openapi/form-module/updateaform","metadata":{"seo":{"title":"Update a form","description":"Updates a form's settings and returns it, the same shape as reading it back.Fields you leave out keep their current values, so a partial body is safe."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateAForm","name":"Update a form","isWebhook":false,"pointer":"/paths/~1api~1v2~1form~1{id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a form","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Updates a form's settings and returns it, the same shape as reading it back."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fields you leave out keep their current values, so a partial body is safe."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"What is required depends on the form type."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Each type declares its own"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"required settings on top of the rules below - most types require "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"form_title"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"success_content"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", so a request that omits them is rejected even though nothing"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"here marks them required. Read the form first and send those values back with"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"your change."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"close_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is only kept if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"close_form"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is sent with it."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Send both to schedule"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"a closing time; send neither and any existing closing time is cleared. This is the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"one field on this endpoint that a partial body does not leave alone."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The form type itself cannot be changed after creation and is not accepted here."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the form.","required":true}],"pointer":"/paths/~1api~1v2~1form~1{id}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1form~1{id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_478"}},"schemaId":"schema_478","pointer":"/paths/~1api~1v2~1form~1{id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v2/form/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_478"}},"responseCodes":["200","404"],"pointer":"/api/v2/form/{id}","href":"form-module/updateaform","openApiOperationId":"updateAForm","summary":"Update a form"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_478","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_478"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_479"}},"schemaId":"schema_479"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"}],"pointer":"/paths/~1api~1v2~1form~1{id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_479","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_479"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/form-module/updateaform"}],"panels":[]}]},"httpPath":"/api/v2/form/{id}"},{"label":"Delete a form","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/form-module/deleteaform","routeSlug":"/api-docs/openapi/form-module/deleteaform","metadata":{"seo":{"title":"Delete a form","description":"Deletes a form. Its fields and its submissions go with it."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteAForm","name":"Delete a form","isWebhook":false,"pointer":"/paths/~1api~1v2~1form~1{id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete a form","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Deletes a form. Its fields and its submissions go with it."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A form that one of the account's settings points at cannot be deleted - the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"registration form, the shift application form and the rest. Clear the setting"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"first, or archive the form instead with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"is_archived"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_317","description":"The ID of the form.","required":true}],"pointer":"/paths/~1api~1v2~1form~1{id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1form~1{id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/v2/form/{id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["204","404","422"],"pointer":"/api/v2/form/{id}","href":"form-module/deleteaform","openApiOperationId":"deleteAForm","summary":"Delete a form"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"No content, successful deletion","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}},"schemaId":"schema_258"},{"code":"422","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_480"}},"schemaId":"schema_480"}],"pointer":"/paths/~1api~1v2~1form~1{id}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"204","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}},{"code":"404","schemaId":"schema_258","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258"}}},{"code":"422","schemaId":"schema_480","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_480"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/form-module/deleteaform"}],"panels":[]}]},"httpPath":"/api/v2/form/{id}"},{"label":"Render a form","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/form-module/renderaform","routeSlug":"/api-docs/openapi/form-module/renderaform","metadata":{"seo":{"title":"Render a form","description":"Returns everything needed to draw a form and fill it in: its fields in order, eachone's type, label, validation bounds and option list, the title and the contentshown on success, and the values already held for whoever is asking. Submit theresult to POST /form/{id}/process."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"renderAForm","name":"Render a form","isWebhook":false,"pointer":"/paths/~1api~1v2~1form~1{form_id}~1view/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Render a form","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns everything needed to draw a form and fill it in: its fields in order, each"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"one's type, label, validation bounds and option list, the title and the content"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"shown on success, and the values already held for whoever is asking. Submit the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"result to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /form/{id}/process"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint does not require a token."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Anonymous forms that the account has"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"marked public can be rendered by anyone holding the form's id or its token - that"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"is what makes a public sign-up link work. Every other form, including an anonymous"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"form that has not been made public, requires a signed-in caller who may use it,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and answers as though it does not exist otherwise. When a form is rendered without"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"a token the response carries "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"recaptcha: true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and the submission that follows"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"must include a reCAPTCHA response."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Either the form's numeric id or its "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"token"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" may be used in the path."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A form that has closed returns its closing content rather than its fields. An"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"administrator can still preview a closed form by sending "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"preview"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to fill the form in on behalf of somebody else; the form type"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"decides which entity ids are required alongside it, and a request missing one is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"rejected. Send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user_form_submission_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to reopen an existing submission - it"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"must belong to this form. Where the form's content contains merge fields, an"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"existing submission renders them against whoever originally submitted it rather"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"than against whoever is reading it."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"form_id","in":"path","schemaId":"schema_481","description":"The id of the form, or its token.","required":true}],"pointer":"/paths/~1api~1v2~1form~1{form_id}~1view/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"user_id","in":"query","schemaId":"schema_482","description":"Fill the form in on behalf of this user."},{"name":"user_form_submission_id","in":"query","schemaId":"schema_483","description":"Reopen this existing submission. Must\n  belong to the form in the path."},{"name":"preview","in":"query","schemaId":"schema_484","description":"Render a closed form anyway. Administrators only."},{"name":"_locale","in":"query","schemaId":"schema_485","description":"Render labels and content in this locale."}],"pointer":"/paths/~1api~1v2~1form~1{form_id}~1view/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1form~1{form_id}~1view/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/form/{form_id}/view","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"form_id","in":"path","required":true,"schemaId":"schema_481"}],"query":[{"name":"user_id","in":"query","required":false,"schemaId":"schema_482"},{"name":"user_form_submission_id","in":"query","required":false,"schemaId":"schema_483"},{"name":"preview","in":"query","required":false,"schemaId":"schema_484"},{"name":"_locale","in":"query","required":false,"schemaId":"schema_485"}],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[],"responseCodes":["200"],"pointer":"/api/v2/form/{form_id}/view","href":"form-module/renderaform","openApiOperationId":"renderAForm","summary":"Render a form"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_486"}},"schemaId":"schema_486"}],"pointer":"/paths/~1api~1v2~1form~1{form_id}~1view/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_486","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_486"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/form-module/renderaform"}],"panels":[]}]},"httpPath":"/api/v2/form/{form_id}/view"},{"label":"Submit a form","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/form-module/submitaform","routeSlug":"/api-docs/openapi/form-module/submitaform","metadata":{"seo":{"title":"Submit a form","description":"Submits the form returned by GET /form/{id}/view, filled in by whoever iscalling. What it creates depends on the form's type: a user, an update to thecaller, or a submission stored on its own."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"submitAForm","name":"Submit a form","isWebhook":false,"pointer":"/paths/~1api~1v2~1form~1{form_id}~1process/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Submit a form","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Submits the form returned by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /form/{id}/view"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", filled in by whoever is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"calling. What it creates depends on the form's type: a user, an update to the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"caller, or a submission stored on its own."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint does not require a token."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Anonymous forms the account has marked"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"public can be submitted by anyone holding the form's id or token, and those"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"submissions must carry a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"recaptcha"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" response. Every other form requires a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"signed-in caller who may use it. Forms that create anything other than a user or a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"standalone submission cannot be submitted here at all."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The body is the form's own fields, sent by the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" each one carries in the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"render response - "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user:custom_email_attribute"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and so on. Validation errors come"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"back keyed by field. Nothing is stored unless the whole submission validates."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The success response is the form rendered again, so the answers just stored can be"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"shown back, with the caller's own previous submissions under "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"submissions"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Where"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the form does not allow resubmission the response is the success content and a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"short message instead, because there is no longer a form to render."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"form_id","in":"path","schemaId":"schema_487","description":"The id of the form, or its token.","required":true}],"pointer":"/paths/~1api~1v2~1form~1{form_id}~1process/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1form~1{form_id}~1process/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_488"}},"schemaId":"schema_488","pointer":"/paths/~1api~1v2~1form~1{form_id}~1process/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/form/{form_id}/process","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"form_id","in":"path","required":true,"schemaId":"schema_487"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"schema_488"}},"responseCodes":["200"],"pointer":"/api/v2/form/{form_id}/process","href":"form-module/submitaform","openApiOperationId":"submitAForm","summary":"Submit a form"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_488","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_488"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_489"}},"schemaId":"schema_489"}],"pointer":"/paths/~1api~1v2~1form~1{form_id}~1process/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_489","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_489"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/form-module/submitaform"}],"panels":[]}]},"httpPath":"/api/v2/form/{form_id}/process"},{"label":"Render a form about a user","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/form-module/renderaformaboutauser","routeSlug":"/api-docs/openapi/form-module/renderaformaboutauser","metadata":{"seo":{"title":"Render a form about a user","description":"Returns a form drawn for an administrator to complete about somebody else, withthe fields already carrying that user's current values. Submit the result toPUT /form/{id}/interact/{user_id}."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"renderAFormAboutAUser","name":"Render a form about a user","isWebhook":false,"pointer":"/paths/~1api~1v2~1form~1{form_id}~1interact~1{user_id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Render a form about a user","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns a form drawn for an administrator to complete about somebody else, with"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the fields already carrying that user's current values. Submit the result to"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PUT /form/{id}/interact/{user_id}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The caller must be able to read both the form and the user; if either is out of"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"reach the endpoint answers as though it does not exist. A caller who may read the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"user but not change them gets the form back with every field disabled, so it can"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"be shown but not submitted."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"form_id","in":"path","schemaId":"schema_317","description":"The ID of the form.","required":true},{"name":"user_id","in":"path","schemaId":"schema_490","description":"The ID of the user.","required":true}],"pointer":"/paths/~1api~1v2~1form~1{form_id}~1interact~1{user_id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1form~1{form_id}~1interact~1{user_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/form/{form_id}/interact/{user_id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"form_id","in":"path","required":true,"schemaId":"schema_317"},{"name":"user_id","in":"path","required":true,"schemaId":"schema_490"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/form/{form_id}/interact/{user_id}","href":"form-module/renderaformaboutauser","openApiOperationId":"renderAFormAboutAUser","summary":"Render a form about a user"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_491"}},"schemaId":"schema_491"}],"pointer":"/paths/~1api~1v2~1form~1{form_id}~1interact~1{user_id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_491","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_491"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/form-module/renderaformaboutauser"}],"panels":[]}]},"httpPath":"/api/v2/form/{form_id}/interact/{user_id}"},{"label":"Submit a form about a user","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/form-module/submitaformaboutauser","routeSlug":"/api-docs/openapi/form-module/submitaformaboutauser","metadata":{"seo":{"title":"Submit a form about a user","description":"Submits the form returned by GET /form/{id}/interact/{user_id}, completed by anadministrator about the user in the path. The caller must be able to change thatuser; otherwise the endpoint answers as though it does not exist."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"submitAFormAboutAUser","name":"Submit a form about a user","isWebhook":false,"pointer":"/paths/~1api~1v2~1form~1{form_id}~1interact~1{user_id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Submit a form about a user","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Submits the form returned by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /form/{id}/interact/{user_id}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", completed by an"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"administrator about the user in the path. The caller must be able to change that"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"user; otherwise the endpoint answers as though it does not exist."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"What the submission does depends on the form's type. An admin interaction form"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"writes the answers straight onto the user and records the change against them. An"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"admin submission form stores the answers as a submission of their own, leaving the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"user untouched, and is restricted to callers who hold a role in the account."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The body is the form's own fields, sent by the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" each one carries in the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"render response - "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user:custom_notes"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and so on. Only fields the visibility rules"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"currently show are read; anything else in the body is ignored rather than"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"rejected. Validation errors come back keyed by field, prefixed with the entity the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"field belongs to."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"form_id","in":"path","schemaId":"schema_317","description":"The ID of the form.","required":true},{"name":"user_id","in":"path","schemaId":"schema_490","description":"The ID of the user.","required":true}],"pointer":"/paths/~1api~1v2~1form~1{form_id}~1interact~1{user_id}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1form~1{form_id}~1interact~1{user_id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_492"}},"schemaId":"schema_492","pointer":"/paths/~1api~1v2~1form~1{form_id}~1interact~1{user_id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v2/form/{form_id}/interact/{user_id}","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"form_id","in":"path","required":true,"schemaId":"schema_317"},{"name":"user_id","in":"path","required":true,"schemaId":"schema_490"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_492"}},"responseCodes":["200","403"],"pointer":"/api/v2/form/{form_id}/interact/{user_id}","href":"form-module/submitaformaboutauser","openApiOperationId":"submitAFormAboutAUser","summary":"Submit a form about a user"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_492","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_492"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_493"}},"schemaId":"schema_493"},{"code":"403","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_494"}},"schemaId":"schema_494"}],"pointer":"/paths/~1api~1v2~1form~1{form_id}~1interact~1{user_id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_493","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_493"}}},{"code":"403","schemaId":"schema_494","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_494"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/form-module/submitaformaboutauser"}],"panels":[]}]},"httpPath":"/api/v2/form/{form_id}/interact/{user_id}"},{"label":"Copy a form","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/form-module/copyaform","routeSlug":"/api-docs/openapi/form-module/copyaform","metadata":{"seo":{"title":"Copy a form","description":"Duplicates a form, along with its fields and its visibility rules, and returns thecopy. Submissions are not copied."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"copyAForm","name":"Copy a form","isWebhook":false,"pointer":"/paths/~1api~1v2~1form~1{form_id}~1copy/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Copy a form","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Duplicates a form, along with its fields and its visibility rules, and returns the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"copy. Submissions are not copied."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Copying within the same account returns the new form and appends "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"(Copy)"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to its"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"name. Copying into another account - send that account's id as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"account_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" -"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"returns a short confirmation instead of the form, because the caller cannot"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"necessarily read what was just created there. Any custom attributes the fields"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"depend on are recreated in the target account if it does not already have them,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and a field whose attribute exists there with a different type is skipped rather"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"than copied wrongly."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"form_id","in":"path","schemaId":"schema_317","description":"The ID of the form.","required":true}],"pointer":"/paths/~1api~1v2~1form~1{form_id}~1copy/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1form~1{form_id}~1copy/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_495"}},"schemaId":"schema_495","pointer":"/paths/~1api~1v2~1form~1{form_id}~1copy/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/form/{form_id}/copy","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"form_id","in":"path","required":true,"schemaId":"schema_317"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_495"}},"responseCodes":["200"],"pointer":"/api/v2/form/{form_id}/copy","href":"form-module/copyaform","openApiOperationId":"copyAForm","summary":"Copy a form"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_495","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_495"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_496"}},"schemaId":"schema_496"}],"pointer":"/paths/~1api~1v2~1form~1{form_id}~1copy/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_496","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_496"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/form-module/copyaform"}],"panels":[]}]},"httpPath":"/api/v2/form/{form_id}/copy"},{"label":"Export a form's responses","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/form-module/exportaformsresponses","routeSlug":"/api-docs/openapi/form-module/exportaformsresponses","metadata":{"seo":{"title":"Export a form's responses","description":"Queues an export of every response to a form and returns a token identifying thequeued job. The file is not in the response - the export is built in thebackground and delivered through the account's usual export delivery, so nothinghere needs polling."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"exportAFormsResponses","name":"Export a form's responses","isWebhook":false,"pointer":"/paths/~1api~1v2~1form~1{form_id}~1export-responses/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Export a form's responses","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Queues an export of every response to a form and returns a token identifying the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"queued job. "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The file is not in the response"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - the export is built in the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"background and delivered through the account's usual export delivery, so nothing"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"here needs polling."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Only the four form types that collect responses can be exported: anonymous forms,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"user interaction forms, submission forms and admin submission forms. Asking for"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"any other type is rejected."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"form_id","in":"path","schemaId":"schema_317","description":"The ID of the form.","required":true}],"pointer":"/paths/~1api~1v2~1form~1{form_id}~1export-responses/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"format","in":"query","schemaId":"schema_497","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The file format. One of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"xlsx"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"csv"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Defaults to"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"xlsx"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}],"pointer":"/paths/~1api~1v2~1form~1{form_id}~1export-responses/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1form~1{form_id}~1export-responses/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/form/{form_id}/export-responses","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"form_id","in":"path","required":true,"schemaId":"schema_317"}],"query":[{"name":"format","in":"query","required":false,"schemaId":"schema_497"}],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/form/{form_id}/export-responses","href":"form-module/exportaformsresponses","openApiOperationId":"exportAFormsResponses","summary":"Export a form's responses"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_498"}},"schemaId":"schema_498"}],"pointer":"/paths/~1api~1v2~1form~1{form_id}~1export-responses/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_498","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_498"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/form-module/exportaformsresponses"}],"panels":[]}]},"httpPath":"/api/v2/form/{form_id}/export-responses"},{"label":"List a form's anonymous submissions","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/form-module/listaformsanonymoussubmissions","routeSlug":"/api-docs/openapi/form-module/listaformsanonymoussubmissions","metadata":{"seo":{"title":"List a form's anonymous submissions","description":"Returns the answers left on an anonymous form - the type that can be filled inwithout signing in. Each row carries the answers as a data object keyed by thefield names the form renders, and nothing identifying who left them, becausenobody signed in to leave them."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listAFormsAnonymousSubmissions","name":"List a form's anonymous submissions","isWebhook":false,"pointer":"/paths/~1api~1v2~1form~1{form_id}~1submission/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List a form's anonymous submissions","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the answers left on an anonymous form - the type that can be filled in"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"without signing in. Each row carries the answers as a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" object keyed by the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"field names the form renders, and nothing identifying who left them, because"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"nobody signed in to leave them."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Only anonymous forms have these."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Every other form type stores its answers"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"against a user; read those through "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /user/{id}/form/user-submission"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instead."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Asking a form of any other type for its submissions returns an empty list rather"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"than an error."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"form_id","in":"path","schemaId":"schema_317","description":"The ID of the form.","required":true}],"pointer":"/paths/~1api~1v2~1form~1{form_id}~1submission/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"per_page","in":"query","schemaId":"schema_262","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of results to return per page. The higher the number the longer the request may take."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is highly recommended to use this to avoid timeouts as your data grows."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate results."},"children":[]}]}]}]},{"name":"page","in":"query","schemaId":"schema_263","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The page of results to return. Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"per_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"results. If not specified, defaults to 1."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response's next_page_url will be null if there are no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"more pages."},"children":[]}]}]}]},{"name":"filter","in":"query","schemaId":"schema_264","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A filter to apply to the results. Declared as an array of objects, where each object"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contains an attr (attribute code), operator and value key. Examples:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=name&filter[0][operator]=like&filter[0][value]=luke"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=id&filter[0][operator]=>&filter[0][value]=265"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the filters documentation for more details on how to use this."},"children":[]}]}]}],"example":null},{"name":"sort_by","in":"query","schemaId":"schema_265","description":"The field to sort the results by. No ordering is applied unless you specify one, so\nrow order is not guaranteed. Always send it when paging through a list, otherwise\nrecords can repeat or be missed between pages.\nExample: id","example":null},{"name":"sort_order","in":"query","schemaId":"schema_266","description":"The direction to sort the results by. Can be 'asc' or 'desc', default is 'asc'.","example":null},{"name":"_locale","in":"query","schemaId":"schema_267","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The locale to use for the response. This primarily affects the results of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contain human-readable labels and terms, as well as locale-specific date formats.,"},"children":[]}]}]}]}],"pointer":"/paths/~1api~1v2~1form~1{form_id}~1submission/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1form~1{form_id}~1submission/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/form/{form_id}/submission","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"form_id","in":"path","required":true,"schemaId":"schema_317"}],"query":[{"name":"per_page","in":"query","required":false,"schemaId":"schema_262"},{"name":"page","in":"query","required":false,"schemaId":"schema_263"},{"name":"filter","in":"query","required":false,"schemaId":"schema_264"},{"name":"sort_by","in":"query","required":false,"schemaId":"schema_265"},{"name":"sort_order","in":"query","required":false,"schemaId":"schema_266"},{"name":"_locale","in":"query","required":false,"schemaId":"schema_267"}],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/form/{form_id}/submission","href":"form-module/listaformsanonymoussubmissions","openApiOperationId":"listAFormsAnonymousSubmissions","summary":"List a form's anonymous submissions"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_499"}},"schemaId":"schema_499"}],"pointer":"/paths/~1api~1v2~1form~1{form_id}~1submission/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_499","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_499"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/form-module/listaformsanonymoussubmissions"}],"panels":[]}]},"httpPath":"/api/v2/form/{form_id}/submission"},{"label":"List a user's form submissions","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/form-module/listausersformsubmissions","routeSlug":"/api-docs/openapi/form-module/listausersformsubmissions","metadata":{"seo":{"title":"List a user's form submissions","description":"Returns every form submission held against one person, across all of the account'sforms. Each row carries the raw answers in object, the same answers rendered fordisplay in nice, and the definition of each field in attributes, so a listingcan be shown without reading the form the answers came from."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listAUsersFormSubmissions","name":"List a user's form submissions","isWebhook":false,"pointer":"/paths/~1api~1v2~1user~1{user_id}~1form~1user-submission/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List a user's form submissions","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns every form submission held against one person, across all of the account's"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"forms. Each row carries the raw answers in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"object"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", the same answers rendered for"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"display in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and the definition of each field in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"attributes"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", so a listing"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"can be shown without reading the form the answers came from."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The caller must be able to read the user in the path; otherwise the endpoint"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"answers as though they do not exist. Filter by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"form_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to narrow the result to"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"one form."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Anonymous form submissions are not included - nobody signed in to leave them, so"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"they belong to no user. Read those through "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /form/{id}/submission"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"user_id","in":"path","schemaId":"schema_490","description":"The ID of the user.","required":true}],"pointer":"/paths/~1api~1v2~1user~1{user_id}~1form~1user-submission/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"per_page","in":"query","schemaId":"schema_262","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of results to return per page. The higher the number the longer the request may take."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is highly recommended to use this to avoid timeouts as your data grows."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate results."},"children":[]}]}]}]},{"name":"page","in":"query","schemaId":"schema_263","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The page of results to return. Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"per_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"results. If not specified, defaults to 1."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response's next_page_url will be null if there are no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"more pages."},"children":[]}]}]}]},{"name":"filter","in":"query","schemaId":"schema_264","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A filter to apply to the results. Declared as an array of objects, where each object"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contains an attr (attribute code), operator and value key. Examples:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=name&filter[0][operator]=like&filter[0][value]=luke"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=id&filter[0][operator]=>&filter[0][value]=265"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the filters documentation for more details on how to use this."},"children":[]}]}]}],"example":null},{"name":"sort_by","in":"query","schemaId":"schema_265","description":"The field to sort the results by. No ordering is applied unless you specify one, so\nrow order is not guaranteed. Always send it when paging through a list, otherwise\nrecords can repeat or be missed between pages.\nExample: id","example":null},{"name":"sort_order","in":"query","schemaId":"schema_266","description":"The direction to sort the results by. Can be 'asc' or 'desc', default is 'asc'.","example":null},{"name":"_locale","in":"query","schemaId":"schema_267","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The locale to use for the response. This primarily affects the results of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contain human-readable labels and terms, as well as locale-specific date formats.,"},"children":[]}]}]}]},{"name":"extras","in":"query","schemaId":"schema_500","description":"A list of extras to include in the response. These are objects or arrays that are not part of\nthe model's primary attributes, such as stats and counts.\nFor fast responses, avoid requesting them if you don't need them. "}],"pointer":"/paths/~1api~1v2~1user~1{user_id}~1form~1user-submission/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1user~1{user_id}~1form~1user-submission/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/user/{user_id}/form/user-submission","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"user_id","in":"path","required":true,"schemaId":"schema_490"}],"query":[{"name":"per_page","in":"query","required":false,"schemaId":"schema_262"},{"name":"page","in":"query","required":false,"schemaId":"schema_263"},{"name":"filter","in":"query","required":false,"schemaId":"schema_264"},{"name":"sort_by","in":"query","required":false,"schemaId":"schema_265"},{"name":"sort_order","in":"query","required":false,"schemaId":"schema_266"},{"name":"_locale","in":"query","required":false,"schemaId":"schema_267"},{"name":"extras","in":"query","required":false,"schemaId":"schema_500"}],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/v2/user/{user_id}/form/user-submission","href":"form-module/listausersformsubmissions","openApiOperationId":"listAUsersFormSubmissions","summary":"List a user's form submissions"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_501"}},"schemaId":"schema_501"}],"pointer":"/paths/~1api~1v2~1user~1{user_id}~1form~1user-submission/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_501","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_501"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/form-module/listausersformsubmissions"}],"panels":[]}]},"httpPath":"/api/v2/user/{user_id}/form/user-submission"},{"label":"Update a user's form submissions in bulk","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-docs/openapi/form-module/updateausersformsubmissionsinbulk","routeSlug":"/api-docs/openapi/form-module/updateausersformsubmissionsinbulk","metadata":{"seo":{"title":"Update a user's form submissions in bulk","description":"Applies one change to many of a person's form submissions at once, and answerswith a plain-text confirmation rather than the rows it changed."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateAUsersFormSubmissionsInBulk","name":"Update a user's form submissions in bulk","isWebhook":false,"pointer":"/paths/~1api~1v2~1user~1{user_id}~1form~1user-submission/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a user's form submissions in bulk","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Applies one change to many of a person's form submissions at once, and answers"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"with a plain-text confirmation rather than the rows it changed."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filter"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" unless you mean every submission that person has."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" There is no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"list of ids to update; the change is applied to whatever the filter selects, and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"an unfiltered request selects all of them. Filter by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"form_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to confine it to"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"one form. The filter takes the same shape as the one on the listing above, so a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"safe way to work is to run the listing with a filter first, check what comes back,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"then send the same filter here."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The change itself is applied directly and does not go back through the form, so"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"neither the form's validation rules nor its visibility rules apply. Requires the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ability to update forms."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"default","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"user_id","in":"path","schemaId":"schema_490","description":"The ID of the user.","required":true}],"pointer":"/paths/~1api~1v2~1user~1{user_id}~1form~1user-submission/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254","description":""}],"pointer":"/paths/~1api~1v2~1user~1{user_id}~1form~1user-submission/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_502"}},"schemaId":"schema_502","pointer":"/paths/~1api~1v2~1user~1{user_id}~1form~1user-submission/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v2/user/{user_id}/form/user-submission","servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"parameters":{"path":[{"name":"user_id","in":"path","required":true,"schemaId":"schema_490"}],"query":[],"querystring":[],"header":[{"name":"Rosterfy-Platform","in":"header","schemaId":"schema_254"}],"cookie":[]},"security":[{"schemes":[{"id":"default","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_502"}},"responseCodes":["200"],"pointer":"/api/v2/user/{user_id}/form/user-submission","href":"form-module/updateausersformsubmissionsinbulk","openApiOperationId":"updateAUsersFormSubmissionsInBulk","summary":"Update a user's form submissions in bulk"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/api-docs/openapi","description":"Mock server","isMockServer":true},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example"},"domain":{"default":"rosterfy.com"}}}],"schemaId":"schema_502","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_502"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"text/plain","mediaTypes":["text/plain"],"mediaTypeContent":{"text/plain":{"schemaId":"schema_503"}},"schemaId":"schema_503"}],"pointer":"/paths/~1api~1v2~1user~1{user_id}~1form~1user-submission/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_503","mediaTypes":["text/plain"],"mediaTypeContent":{"text/plain":{"schemaId":"schema_503"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/form-module/updateausersformsubmissionsinbulk"}],"panels":[]}]},"httpPath":"/api/v2/user/{user_id}/form/user-submission"}],"content":{"contentType":"group","meta":{"name":"Form Module"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Form Module","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v2/form","summary":"List forms","prefix":{"name":"get","color":"get"},"badges":[],"link":"/form-module/listforms","deprecated":false},{"title":"/api/v2/form","summary":"Create a form","prefix":{"name":"post","color":"post"},"badges":[],"link":"/form-module/createaform","deprecated":false},{"title":"/api/v2/form/{id}","summary":"Update a form","prefix":{"name":"put","color":"put"},"badges":[],"link":"/form-module/updateaform","deprecated":false},{"title":"/api/v2/form/{id}","summary":"Delete a form","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/form-module/deleteaform","deprecated":false},{"title":"/api/v2/form/{form_id}/view","summary":"Render a form","prefix":{"name":"get","color":"get"},"badges":[],"link":"/form-module/renderaform","deprecated":false},{"title":"/api/v2/form/{form_id}/process","summary":"Submit a form","prefix":{"name":"post","color":"post"},"badges":[],"link":"/form-module/submitaform","deprecated":false},{"title":"/api/v2/form/{form_id}/interact/{user_id}","summary":"Render a form about a user","prefix":{"name":"get","color":"get"},"badges":[],"link":"/form-module/renderaformaboutauser","deprecated":false},{"title":"/api/v2/form/{form_id}/interact/{user_id}","summary":"Submit a form about a user","prefix":{"name":"put","color":"put"},"badges":[],"link":"/form-module/submitaformaboutauser","deprecated":false},{"title":"/api/v2/form/{form_id}/copy","summary":"Copy a form","prefix":{"name":"post","color":"post"},"badges":[],"link":"/form-module/copyaform","deprecated":false},{"title":"/api/v2/form/{form_id}/export-responses","summary":"Export a form's responses","prefix":{"name":"get","color":"get"},"badges":[],"link":"/form-module/exportaformsresponses","deprecated":false},{"title":"/api/v2/form/{form_id}/submission","summary":"List a form's anonymous submissions","prefix":{"name":"get","color":"get"},"badges":[],"link":"/form-module/listaformsanonymoussubmissions","deprecated":false},{"title":"/api/v2/user/{user_id}/form/user-submission","summary":"List a user's form submissions","prefix":{"name":"get","color":"get"},"badges":[],"link":"/form-module/listausersformsubmissions","deprecated":false},{"title":"/api/v2/user/{user_id}/form/user-submission","summary":"Update a user's form submissions in bulk","prefix":{"name":"put","color":"put"},"badges":[],"link":"/form-module/updateausersformsubmissionsinbulk","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"schema_252":{"kind":"json-schema","data":{"type":"object","required":["grant_type","client_id","client_secret"],"properties":{"grant_type":{"type":"string","enum":["password","refresh_token"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The exchange being performed. Send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"password"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for the initial exchange, or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"refresh_token"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to renew an existing token."},"children":[]}]}]}],"examples":["password"]},"client_id":{"type":"integer","description":"The id of the personal access client the credentials belong to.","examples":[1234]},"client_secret":{"type":"string","description":"The secret issued with that client.","examples":["{YOUR_CLIENT_SECRET}"]},"username":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The email address of the user the token is issued for. Required when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"grant_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"password"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":["integration@example.com"]},"password":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"That user's password. Required when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"grant_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"password"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":["{YOUR_PASSWORD}"]},"refresh_token":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The refresh token from an earlier exchange. Required when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"grant_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"refresh_token"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and ignored otherwise."},"children":[]}]}]}],"examples":["{YOUR_REFRESH_TOKEN}"]},"scope":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional. Omit it, or send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"*"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", to receive a token carrying the whole of the user's access."},"children":[]}]}]}],"examples":["*"]}}},"id":"schema_252"},"schema_253":{"kind":"json-schema","data":{"type":"object","properties":{"token_type":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Always "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Bearer"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". This is the scheme to use in the Authorization header."},"children":[]}]}]}],"examples":["Bearer"]},"expires_in":{"type":"integer","description":"Seconds until the access token expires.","examples":[2592000]},"access_token":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The token to send as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":["{ACCESS_TOKEN}"]},"refresh_token":{"type":"string","description":"Exchange this for a new access token before the current one expires.","examples":["{REFRESH_TOKEN}"]}}},"id":"schema_253"},"schema_254":{"kind":"json-schema","data":{"type":"string","examples":["admin"]},"id":"schema_254"},"schema_255":{"kind":"json-schema","data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","examples":[1234]},"user_id":{"type":"integer","examples":[1234]},"name":{"type":"string","examples":["Nightly roster export"]},"provider":{"type":["string","null"],"examples":[null]},"redirect":{"type":"string","examples":["https://example.com/oauth/callback"]},"personal_access_client":{"type":"boolean","examples":[true]},"password_client":{"type":"boolean","examples":[false]},"revoked":{"type":"boolean","examples":[false]},"created_at":{"type":"string","examples":["2026-01-14T02:08:00.000000Z"]},"updated_at":{"type":"string","examples":["2026-01-14T02:08:00.000000Z"]}}},"examples":[[{"id":1234,"user_id":1234,"name":"Nightly roster export","provider":null,"redirect":"https://example.com/oauth/callback","personal_access_client":true,"password_client":false,"revoked":false,"created_at":"2026-01-14T02:08:00.000000Z","updated_at":"2026-01-14T02:08:00.000000Z"},{"id":1235,"user_id":1234,"name":"Volunteer portal sync","provider":null,"redirect":"https://example.com/oauth/callback","personal_access_client":true,"password_client":false,"revoked":false,"created_at":"2026-02-03T09:41:17.000000Z","updated_at":"2026-02-03T09:41:17.000000Z"}]]},"id":"schema_255"},"schema_256":{"kind":"json-schema","data":{"type":"object","properties":{"name":{"type":"string","description":"A label for the client, shown wherever the client is listed. Use something that identifies the system that will hold the credentials, so a client can be recognised and withdrawn later without guesswork.","examples":[null]},"redirect":{"type":"string","description":"The absolute URL an authorisation response is returned to. Required in practice: a request that omits it fails, so send a URL you control even when the integration never redirects a browser anywhere.","examples":[null]}},"required":["name","redirect"]},"id":"schema_256"},"schema_257":{"kind":"json-schema","data":{"type":"object","properties":{"user_id":{"type":"integer","examples":[1234]},"name":{"type":"string","examples":["Nightly roster export"]},"provider":{"type":["string","null"],"examples":[null]},"redirect":{"type":"string","examples":["https://example.com/oauth/callback"]},"personal_access_client":{"type":"boolean","examples":[true]},"password_client":{"type":"boolean","examples":[false]},"revoked":{"type":"boolean","examples":[false]},"updated_at":{"type":"string","examples":["2026-01-14T02:08:00.000000Z"]},"created_at":{"type":"string","examples":["2026-01-14T02:08:00.000000Z"]},"id":{"type":"integer","examples":[1234]}},"examples":[{"user_id":1234,"name":"Nightly roster export","provider":null,"redirect":"https://example.com/oauth/callback","personal_access_client":true,"password_client":false,"revoked":false,"updated_at":"2026-01-14T02:08:00.000000Z","created_at":"2026-01-14T02:08:00.000000Z","id":1234}]},"id":"schema_257"},"schema_258":{"kind":"json-schema","data":{"type":["object","null"]},"id":"schema_258"},"schema_259":{"kind":"json-schema","data":{"type":"object","properties":{"user":{"type":"object","properties":{"id":{"type":"integer","examples":[1234]},"account_id":{"type":"integer","examples":[20101]},"email":{"type":"string","examples":["alex.example@example.com"]},"force_reset_password":{"type":"integer","examples":[0]},"password_expires_at":{"type":["string","null"],"examples":[null]},"first_name":{"type":"string","examples":["Alex"]},"middle_name":{"type":["string","null"],"examples":[null]},"last_name":{"type":"string","examples":["Example"]},"preferred_name":{"type":["string","null"],"examples":[null]},"phone":{"type":"string","examples":["au-200000000"]},"dob":{"type":"string","examples":["1990-01-15"]},"picture":{"type":["string","null"],"examples":[null]},"picture_status":{"type":"integer","examples":[0]},"is_subscribed":{"type":"integer","examples":[0]},"is_subscribed_transactional":{"type":"integer","examples":[1]},"is_unreachable":{"type":"integer","examples":[0]},"is_unreachable_sms":{"type":"integer","examples":[0]},"terms":{"type":"integer","examples":[1]},"rating":{"type":"string","examples":["0.00"]},"shift_privacy":{"type":"integer","examples":[1]},"is_team_leader":{"type":"integer","examples":[0]},"email_verified":{"type":"integer","examples":[0]},"login_lockout_attempts":{"type":"integer","examples":[0]},"login_lockout_at":{"type":["string","null"],"examples":[null]},"login_lockout_email_sent_at":{"type":["string","null"],"examples":[null]},"last_login_at":{"type":"string","examples":["2026-01-20T02:14:52.000000Z"]},"last_app_login_at":{"type":["string","null"],"examples":[null]},"is_archived":{"type":"integer","examples":[0]},"last_activated":{"type":["string","null"],"examples":[null]},"from_source":{"type":["string","null"],"examples":[null]},"delete_requested_at":{"type":["string","null"],"examples":[null]},"deleted_at":{"type":["string","null"],"examples":[null]},"is_erased":{"type":"integer","examples":[0]},"created_at":{"type":"string","examples":["2026-01-05T01:32:57.000000Z"]},"updated_at":{"type":"string","examples":["2026-01-20T01:42:50.000000Z"]},"deleted_by":{"type":["string","null"],"examples":[null]},"interests":{"type":["string","null"],"examples":[null]},"address":{"type":"object","properties":{"iso":{"type":"string","examples":["AUS"]},"region_code":{"type":"string","examples":["VIC"]},"coordinates":{"type":"object","properties":{"latitude":{"type":["string","null"],"examples":[null]},"longitude":{"type":["string","null"],"examples":[null]}}},"street_address_1":{"type":"string","examples":["1 Example Street"]},"street_address_2":{"type":["string","null"],"examples":[null]},"street_address_3":{"type":["string","null"],"examples":[null]},"city":{"type":"string","examples":["Example City"]},"postcode":{"type":"string","examples":["1000"]},"region":{"type":"string","examples":["VIC"]},"country":{"type":"string","examples":["AU"]},"latitude":{"type":["string","null"],"examples":[null]},"longitude":{"type":["string","null"],"examples":[null]}}},"rrn":{"type":"string","examples":["rrn:local:20101:user:AAAABBBBCCCCDDDDEEEEFFFF"]},"age":{"type":"integer","examples":[36]},"checkpoint_id":{"type":"integer","examples":[3]},"type_id":{"type":"integer","examples":[2]},"eula_agreed":{"type":"boolean","examples":[false]},"qr_code":{"type":"string","examples":["https://example.rosterfy.com/qr/qr-example.png"]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:user:AAAABBBBCCCCDDDDEEEEFFFF"]},"family_id":{"type":["string","null"],"examples":[null]},"has_family_members":{"type":"string","examples":["No"]},"manages_family":{"type":"boolean","examples":[false]},"family_manager":{"type":"string","examples":["No"]},"family_member":{"type":"string","examples":["No"]},"is_family_member":{"type":"boolean","examples":[false]},"is_engaged":{"type":"string","examples":["No"]},"is_engaged:raw":{"type":"boolean","examples":[false]},"last_engaged_at":{"type":["string","null"],"examples":[null]},"last_engaged_at:raw":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["Jun 9, 2026, 5:33 AM"]},"created_at__date":{"type":"string","examples":["Jun 9, 2026"]},"created_at__time":{"type":"string","examples":["5:33 AM"]},"created_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"created_at__offset_minutes":{"type":"integer","examples":[0]},"created_at__dayofweek":{"type":"string","examples":["Tuesday"]},"email_verified":{"type":"string","examples":["No"]},"from_source":{"type":"string","examples":[""]},"interests":{"type":["string","null"],"examples":[null]},"interests:value":{"type":["string","null"],"examples":[null]},"interests:array":{"type":["string","null"],"examples":[null]},"is_subscribed_transactional":{"type":"string","examples":["Yes"]},"is_team_leader":{"type":"string","examples":["No"]},"last_login_at":{"type":"string","examples":["Aug 10, 2026, 5:16 AM"]},"last_login_at__date":{"type":"string","examples":["Aug 10, 2026"]},"last_login_at__time":{"type":"string","examples":["5:16 AM"]},"last_login_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"last_login_at__offset_minutes":{"type":"integer","examples":[0]},"last_login_at__dayofweek":{"type":"string","examples":["Monday"]},"middle_name":{"type":"string","examples":[""]},"picture_status":{"type":"string","examples":["N/A"]},"picture_status:value":{"type":"integer","examples":[0]},"picture_status:array":{"type":"string","examples":["N/A"]},"shift_privacy":{"type":"string","examples":["Yes"]},"updated_at":{"type":"string","examples":["Jun 9, 2026, 5:33 AM"]},"updated_at__date":{"type":"string","examples":["Jun 9, 2026"]},"updated_at__time":{"type":"string","examples":["5:33 AM"]},"updated_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"updated_at__offset_minutes":{"type":"integer","examples":[0]},"updated_at__dayofweek":{"type":"string","examples":["Tuesday"]},"first_name":{"type":"string","examples":["Alex"]},"last_name":{"type":"string","examples":["Example"]},"preferred_name":{"type":"string","examples":[""]},"dob":{"type":"string","examples":["Jan 15, 1990"]},"dob__dayofweek":{"type":"string","examples":["Monday"]},"is_subscribed":{"type":"string","examples":["No"]},"terms":{"type":"string","examples":["Yes"]},"name":{"type":"string","examples":["Alex Example"]},"age":{"type":"integer","examples":[36]},"age_months":{"type":"string","examples":["36 years, 0 months"]},"info":{"type":"string","examples":["Alex Example (alex.example@example.com)"]},"preferred_first_name":{"type":"string","examples":["Alex"]},"delete_requested":{"type":"boolean","examples":[false]},"updated_hours":{"type":"number","examples":[1487.7417004144]},"is_community_user":{"type":"boolean","examples":[false]},"timezone":{"type":"string","examples":["UTC"]},"address":{"type":"string","examples":["1 Example Street\nExample City\nVictoria\nAustralia\n1000"]},"address_oneline":{"type":"string","examples":["1 Example Street, Example City, Victoria, Australia, 1000"]},"address.country":{"type":"string","examples":["Australia"]},"address.country:raw":{"type":"string","examples":["AUS"]},"phone":{"type":"string","examples":["(+61) 200000000"]},"phone:raw":{"type":"string","examples":["+61200000000"]}}},"type":{"type":"object","properties":{"id":{"type":"integer","examples":[2]},"account_branding_id":{"type":["string","null"],"examples":[null]},"name":{"type":"string","examples":["Default"]},"code":{"type":"string","examples":["default"]},"profile_form_id":{"type":["string","null"],"examples":[null]},"training_ids":{"type":["string","null"],"examples":[null]},"registration_form_id":{"type":["string","null"],"examples":[null]},"shift_limit":{"type":"integer","examples":[0]},"shift_max_time":{"type":["string","null"],"examples":[null]},"max_shift_length":{"type":"integer","examples":[0]},"min_shift_length":{"type":"integer","examples":[0]},"min_consecutive_rest_time_per_week":{"type":"integer","examples":[0]},"max_work_days_per_week":{"type":"integer","examples":[0]},"gap_between_shifts":{"type":"integer","examples":[0]},"group_leader_attributes":{"type":["string","null"],"examples":[null]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-06-09T05:33:39.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:33:39.000000Z"]},"uuid":{"type":"string","examples":["0cdefc27-b599-4a15-a82f-18c11bb44803"]}}},"permissions":{"type":"object","properties":{"admin":{"type":"boolean","examples":[true]},"event":{"type":"boolean","examples":[true]},"event:create":{"type":"boolean","examples":[true]},"event:read":{"type":"boolean","examples":[true]},"event:update":{"type":"boolean","examples":[true]},"event:delete":{"type":"boolean","examples":[true]},"user":{"type":"boolean","examples":[true]},"user:create":{"type":"boolean","examples":[true]},"user:read":{"type":"boolean","examples":[true]},"user:update":{"type":"boolean","examples":[true]},"user:delete":{"type":"boolean","examples":[true]},"training":{"type":"boolean","examples":[true]},"training:read":{"type":"boolean","examples":[true]},"report":{"type":"boolean","examples":[true]},"report:read":{"type":"boolean","examples":[true]}}},"checkpoint":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"user_checkpoint_type_id":{"type":["string","null"],"examples":[null]},"name":{"type":"string","examples":["Default"]},"label":{"type":"string","examples":["default"]},"permissions":{"type":"object","properties":{"all":{"type":"string","examples":["1"]}}},"actions":{"type":"array","examples":[[]]},"is_inheritable":{"type":"integer","examples":[0]},"sort_order":{"type":"integer","examples":[0]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-06-09T05:33:39.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:34:24.000000Z"]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:checkpoint:1"]},"content_id":{"type":"integer","examples":[3]},"account_name_path":{"type":"string","examples":["Example Organisation"]},"is_foreign_account":{"type":"boolean","examples":[false]}}},"relations":{"type":"object","properties":{"user_checkpoint_type":{"type":["string","null"],"examples":[null]}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[false]}}}}},"checkpoint_permissions":{"type":"object","properties":{"training":{"type":"boolean","examples":[true]},"contact":{"type":"boolean","examples":[true]},"event":{"type":"object","properties":{"type":{"type":"boolean","examples":[true]},"apply_to_shifts":{"type":"boolean","examples":[true]},"calendar":{"type":"boolean","examples":[true]},"history":{"type":"boolean","examples":[true]},"has_enabled_shift_type":{"type":"boolean","examples":[true]},"shift_type":{"type":"boolean","examples":[true]},"activites":{"type":"boolean","examples":[true]},"use_leader_mode_when_not_checked_in":{"type":"boolean","examples":[true]},"shift_calendar":{"type":"boolean","examples":[true]}}},"blog":{"type":"object","properties":{"article":{"type":"boolean","examples":[true]}}},"rewardpoint":{"type":"boolean","examples":[true]},"inventory":{"type":"boolean","examples":[true]},"role_offer":{"type":"object","properties":{"apply":{"type":"boolean","examples":[true]},"has_enabled_functional_area":{"type":"boolean","examples":[true]},"functional_area":{"type":"boolean","examples":[true]}}},"integration":{"type":"object","properties":{"fundraising":{"type":"boolean","examples":[true]}}},"subaccount":{"type":"boolean","examples":[true]},"view_subaccount_selection_menu":{"type":"boolean","examples":[true]},"availability":{"type":"boolean","examples":[true]},"certificate":{"type":"boolean","examples":[true]},"eav":{"type":"object","properties":{"has_disabled_attributes":{"type":"boolean","examples":[true]},"disabled_attributes":{"type":"boolean","examples":[true]}}},"user_group":{"type":"boolean","examples":[true]},"messaging":{"type":"object","properties":{"access":{"type":"boolean","examples":[true]}}}}},"settings":{"type":"object","properties":{"general:locale":{"type":"string","examples":["en-AU"]},"general:timezone":{"type":"string","examples":["Australia/Melbourne"]},"general:advanced_pagination":{"type":"boolean","examples":[false]},"general:high_accessibility":{"type":"boolean","examples":[false]},"availability:advanced":{"type":"boolean","examples":[false]},"availability:available_by_default":{"type":"boolean","examples":[true]},"security:2fa":{"type":"string","examples":[""]}}},"socials":{"type":"array","examples":[[]]},"is_primary_account":{"type":"boolean","examples":[true]},"has_account_roles":{"type":"boolean","examples":[true]},"messaging_user_id":{"type":["string","null"],"examples":[null]}},"examples":[{"user":{"id":1234,"account_id":20101,"email":"alex.example@example.com","force_reset_password":0,"password_expires_at":null,"first_name":"Alex","middle_name":null,"last_name":"Example","preferred_name":null,"phone":"au-200000000","dob":"1990-01-15","picture":null,"picture_status":0,"is_subscribed":0,"is_subscribed_transactional":1,"is_unreachable":0,"is_unreachable_sms":0,"terms":1,"rating":"0.00","shift_privacy":1,"is_team_leader":0,"email_verified":0,"login_lockout_attempts":0,"login_lockout_at":null,"login_lockout_email_sent_at":null,"last_login_at":"2026-01-20T02:14:52.000000Z","last_app_login_at":null,"is_archived":0,"last_activated":null,"from_source":null,"delete_requested_at":null,"deleted_at":null,"is_erased":0,"created_at":"2026-01-05T01:32:57.000000Z","updated_at":"2026-01-20T01:42:50.000000Z","deleted_by":null,"interests":null,"address":{"iso":"AUS","region_code":"VIC","coordinates":{"latitude":null,"longitude":null},"street_address_1":"1 Example Street","street_address_2":null,"street_address_3":null,"city":"Example City","postcode":"1000","region":"VIC","country":"AU","latitude":null,"longitude":null},"rrn":"rrn:local:20101:user:AAAABBBBCCCCDDDDEEEEFFFF","age":36,"checkpoint_id":3,"type_id":2,"eula_agreed":false,"qr_code":"https://example.rosterfy.com/qr/qr-example.png"},"nice":{"rrn":"rrn:local:20101:user:AAAABBBBCCCCDDDDEEEEFFFF","family_id":null,"has_family_members":"No","manages_family":false,"family_manager":"No","family_member":"No","is_family_member":false,"is_engaged":"No","is_engaged:raw":false,"last_engaged_at":null,"last_engaged_at:raw":null,"created_at":"Jun 9, 2026, 5:33 AM","created_at__date":"Jun 9, 2026","created_at__time":"5:33 AM","created_at__offset":" (+00:00 UTC)","created_at__offset_minutes":0,"created_at__dayofweek":"Tuesday","email_verified":"No","from_source":"","interests":null,"interests:value":null,"interests:array":null,"is_subscribed_transactional":"Yes","is_team_leader":"No","last_login_at":"Aug 10, 2026, 5:16 AM","last_login_at__date":"Aug 10, 2026","last_login_at__time":"5:16 AM","last_login_at__offset":" (+00:00 UTC)","last_login_at__offset_minutes":0,"last_login_at__dayofweek":"Monday","middle_name":"","picture_status":"N/A","picture_status:value":0,"picture_status:array":"N/A","shift_privacy":"Yes","updated_at":"Jun 9, 2026, 5:33 AM","updated_at__date":"Jun 9, 2026","updated_at__time":"5:33 AM","updated_at__offset":" (+00:00 UTC)","updated_at__offset_minutes":0,"updated_at__dayofweek":"Tuesday","first_name":"Alex","last_name":"Example","preferred_name":"","dob":"Jan 15, 1990","dob__dayofweek":"Monday","is_subscribed":"No","terms":"Yes","name":"Alex Example","age":36,"age_months":"36 years, 0 months","info":"Alex Example (alex.example@example.com)","preferred_first_name":"Alex","delete_requested":false,"updated_hours":1487.7417004144,"is_community_user":false,"timezone":"UTC","address":"1 Example Street\nExample City\nVictoria\nAustralia\n1000","address_oneline":"1 Example Street, Example City, Victoria, Australia, 1000","address.country":"Australia","address.country:raw":"AUS","phone":"(+61) 200000000","phone:raw":"+61200000000"},"type":{"id":2,"account_branding_id":null,"name":"Default","code":"default","profile_form_id":null,"training_ids":null,"registration_form_id":null,"shift_limit":0,"shift_max_time":null,"max_shift_length":0,"min_shift_length":0,"min_consecutive_rest_time_per_week":0,"max_work_days_per_week":0,"gap_between_shifts":0,"group_leader_attributes":null,"deleted_at":null,"created_at":"2026-06-09T05:33:39.000000Z","updated_at":"2026-06-09T05:33:39.000000Z","uuid":"0cdefc27-b599-4a15-a82f-18c11bb44803"},"permissions":{"admin":true,"event":true,"event:create":true,"event:read":true,"event:update":true,"event:delete":true,"user":true,"user:create":true,"user:read":true,"user:update":true,"user:delete":true,"training":true,"training:read":true,"report":true,"report:read":true},"checkpoint":{"object":{"id":1,"user_checkpoint_type_id":null,"name":"Default","label":"default","permissions":{"all":"1"},"actions":[],"is_inheritable":0,"sort_order":0,"deleted_at":null,"created_at":"2026-06-09T05:33:39.000000Z","updated_at":"2026-06-09T05:34:24.000000Z"},"nice":{"rrn":"rrn:local:20101:checkpoint:1","content_id":3,"account_name_path":"Example Organisation","is_foreign_account":false},"relations":{"user_checkpoint_type":null},"permissions":{"read":true,"update":true,"delete":false}},"checkpoint_permissions":{"training":true,"contact":true,"event":{"type":true,"apply_to_shifts":true,"calendar":true,"history":true,"has_enabled_shift_type":true,"shift_type":true,"activites":true,"use_leader_mode_when_not_checked_in":true,"shift_calendar":true},"blog":{"article":true},"rewardpoint":true,"inventory":true,"role_offer":{"apply":true,"has_enabled_functional_area":true,"functional_area":true},"integration":{"fundraising":true},"subaccount":true,"view_subaccount_selection_menu":true,"availability":true,"certificate":true,"eav":{"has_disabled_attributes":true,"disabled_attributes":true},"user_group":true,"messaging":{"access":true}},"settings":{"general:locale":"en-AU","general:timezone":"Australia/Melbourne","general:advanced_pagination":false,"general:high_accessibility":false,"availability:advanced":false,"availability:available_by_default":true,"security:2fa":""},"socials":[],"is_primary_account":true,"has_account_roles":true,"messaging_user_id":null}]},"id":"schema_259"},"schema_260":{"kind":"json-schema","data":{"type":"object","properties":{"account":{"type":"object","properties":{"id":{"type":"integer","examples":[20101]},"rrn":{"type":"string","examples":["rrn:local:20101:account:20101"]},"parent_id":{"type":["string","null"],"examples":[null]},"parent_url":{"type":["string","null"],"examples":[null]},"parent_account_name":{"type":["string","null"],"examples":[null]},"status":{"type":"string","examples":["approved"]},"can_request_deletion":{"type":"boolean","examples":[true]},"has_support_email":{"type":"boolean","examples":[false]},"delete_requested_at":{"type":["string","null"],"examples":[null]},"allow_family":{"type":"boolean","examples":[true]},"is_archived":{"type":"boolean","examples":[false]},"has_latest_eula":{"type":"boolean","examples":[false]},"has_payment_integration":{"type":"boolean","examples":[false]},"is_locked":{"type":"boolean","examples":[false]},"is_trial":{"type":"boolean","examples":[false]},"has_seek_volunteer_integration":{"type":"boolean","examples":[false]}}},"settings":{"type":"object","properties":{"general:available_locales":{"type":"array","items":{"type":"string"},"examples":[["en-US"]]},"general:locale":{"type":"string","examples":["en-AU"]},"general:timezone":{"type":"string","examples":["Australia/Melbourne"]},"general:location":{"type":"array","items":{"type":"number"},"examples":[[-37.829632,144.957956]]},"users:register":{"type":"integer","examples":[1]},"email:from_email":{"type":"string","examples":["noreply@example.com"]},"email:from_name":{"type":"string","examples":["Example Organisation"]}}},"terms":{"type":"object","properties":{"rosterfy":{"type":"string","examples":["Rosterfy"]},"admin":{"type":"string","examples":["Admin"]},"portal":{"type":"string","examples":["Portal"]},"user":{"type":"string","examples":["User"]},"users":{"type":"string","examples":["Users"]},"event":{"type":"string","examples":["Event"]},"events":{"type":"string","examples":["Events"]},"shift":{"type":"string","examples":["Shift"]},"shifts":{"type":"string","examples":["Shifts"]},"account":{"type":"string","examples":["Account"]},"accounts":{"type":"string","examples":["Accounts"]},"subaccount":{"type":"string","examples":["Subaccount"]},"subaccounts":{"type":"string","examples":["Subaccounts"]}}},"locales":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","examples":["en-AU"]},"text":{"type":"string","examples":["English (Australia)"]}}},"examples":[[{"value":"en-AU","text":"English (Australia)"},{"value":"en-GB","text":"English (United Kingdom)"},{"value":"en-US","text":"English (United States)"}]]},"extras":{"type":"object","properties":{"datadog":{"type":"object","properties":{"client_token":{"type":"string","examples":["pub00000000000000000000000000000000"]},"application_id":{"type":"string","examples":["00000000-0000-0000-0000-000000000000"]},"service":{"type":"string","examples":["rosterfy"]},"sample_rate":{"type":"string","examples":["100"]},"premium_sample_rate":{"type":"string","examples":["100"]},"track_interactions":{"type":"boolean","examples":[true]},"version":{"type":"string","examples":["1.0.0"]}}},"thresholds":{"type":"array","examples":[[]]},"level_1_account_rrn":{"type":"string","examples":["rrn:local:20101:account:20101"]},"intercom_app_id":{"type":"string","examples":["example0"]},"messaging_api_key":{"type":"string","examples":["example0key0"]},"messaging_channel_limit":{"type":"integer","examples":[10000]},"show_channel_count":{"type":"boolean","examples":[false]}}}},"examples":[{"account":{"id":20101,"rrn":"rrn:local:20101:account:20101","parent_id":null,"parent_url":null,"parent_account_name":null,"status":"approved","can_request_deletion":true,"has_support_email":false,"delete_requested_at":null,"allow_family":true,"is_archived":false,"has_latest_eula":false,"has_payment_integration":false,"is_locked":false,"is_trial":false,"has_seek_volunteer_integration":false},"settings":{"general:available_locales":["en-US"],"general:locale":"en-AU","general:timezone":"Australia/Melbourne","general:location":[-37.829632,144.957956],"users:register":1,"email:from_email":"noreply@example.com","email:from_name":"Example Organisation"},"terms":{"rosterfy":"Rosterfy","admin":"Admin","portal":"Portal","user":"User","users":"Users","event":"Event","events":"Events","shift":"Shift","shifts":"Shifts","account":"Account","accounts":"Accounts","subaccount":"Subaccount","subaccounts":"Subaccounts"},"locales":[{"value":"en-AU","text":"English (Australia)"},{"value":"en-GB","text":"English (United Kingdom)"},{"value":"en-US","text":"English (United States)"}],"extras":{"datadog":{"client_token":"pub00000000000000000000000000000000","application_id":"00000000-0000-0000-0000-000000000000","service":"rosterfy","sample_rate":"100","premium_sample_rate":"100","track_interactions":true,"version":"1.0.0"},"thresholds":[],"level_1_account_rrn":"rrn:local:20101:account:20101","intercom_app_id":"example0","messaging_api_key":"example0key0","messaging_channel_limit":10000,"show_channel_count":false}}]},"id":"schema_260"},"schema_261":{"kind":"json-schema","data":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","examples":["reward_point_balance"]},"label":{"type":"string","examples":["Reward point balance"]},"value":{"type":"integer","examples":[0]},"icon":{"type":"string","examples":["fas fa-medal"]}}},"examples":[[{"code":"reward_point_balance","label":"Reward point balance","value":0,"icon":"fas fa-medal"},{"code":"total_number_of_events","label":"Total Number Of Events","value":4,"icon":"fas fa-star"},{"code":"total_number_of_shifts","label":"Total Number Of Shifts","value":4,"icon":"fas fa-calendar-alt"},{"code":"total_shift_hours","label":"Total Shift Hours Attended (By Scheduled Time)","value":18,"icon":"fas fa-clock"}]]},"id":"schema_261"},"schema_262":{"kind":"json-schema","data":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of results to return per page. The higher the number the longer the request may take."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is highly recommended to use this to avoid timeouts as your data grows."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate results."},"children":[]}]}]}],"examples":[5]},"id":"schema_262"},"schema_263":{"kind":"json-schema","data":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The page of results to return. Used in conjunction with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"per_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to paginate"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"results. If not specified, defaults to 1."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response's next_page_url will be null if there are no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"more pages."},"children":[]}]}]}],"examples":[1]},"id":"schema_263"},"schema_264":{"kind":"json-schema","data":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A filter to apply to the results. Declared as an array of objects, where each object"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contains an attr (attribute code), operator and value key. Examples:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=name&filter[0][operator]=like&filter[0][value]=luke"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"?filter[0]['attr']=id&filter[0][operator]=>&filter[0][value]=265"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the filters documentation for more details on how to use this."},"children":[]}]}]}],"items":{"type":"object"},"examples":[null]},"id":"schema_264"},"schema_265":{"kind":"json-schema","data":{"type":"string","description":"The field to sort the results by. No ordering is applied unless you specify one, so\nrow order is not guaranteed. Always send it when paging through a list, otherwise\nrecords can repeat or be missed between pages.\nExample: id","examples":[null]},"id":"schema_265"},"schema_266":{"kind":"json-schema","data":{"type":"string","description":"The direction to sort the results by. Can be 'asc' or 'desc', default is 'asc'.","enum":["asc","desc"],"examples":[null]},"id":"schema_266"},"schema_267":{"kind":"json-schema","data":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The locale to use for the response. This primarily affects the results of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, which"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contain human-readable labels and terms, as well as locale-specific date formats.,"},"children":[]}]}]}],"examples":["en-US"]},"id":"schema_267"},"schema_268":{"kind":"json-schema","data":{"type":"array","description":"A list of extras to include in the response. These are objects or arrays that are not part of\nthe model's primary attributes, such as stats and counts.\nFor fast responses, avoid requesting them if you don't need them. ","items":{"type":"string","enum":["certificate_stats"]},"examples":[["certificate_stats"]]},"id":"schema_268"},"schema_269":{"kind":"json-schema","data":{"type":"array","items":{"type":"object","properties":{"current_page":{"type":"integer","examples":[1]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"name":{"type":"string","examples":["Site Safety Induction"]},"short_description":{"type":["string","null"],"examples":[null]},"thumbnail_url":{"type":["string","null"],"examples":[null]},"account_id":{"type":"integer","examples":[20101]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-01-12T06:55:00.000000Z"]},"updated_at":{"type":"string","examples":["2026-01-12T06:55:00.000000Z"]},"success_message":{"type":"string","examples":["You have completed the induction."]},"is_archived":{"type":"integer","examples":[0]},"is_elective":{"type":"integer","examples":[0]},"estimated_complete_time":{"type":"integer","examples":[11]},"ttl":{"type":"integer","examples":[0]},"pass_score":{"type":"integer","examples":[0]},"is_library":{"type":"integer","examples":[0]},"publish":{"type":"integer","examples":[1]},"service":{"type":"string","examples":["online"]},"external_id":{"type":["string","null"],"examples":[null]},"meta":{"type":"array","examples":[[]]},"sort_order":{"type":"integer","examples":[0]},"certificate_id":{"type":["string","null"],"examples":[null]},"form_id":{"type":["string","null"],"examples":[null]},"type_id":{"type":["string","null"],"examples":[null]},"is_inheritable":{"type":"integer","examples":[0]}}},"nice":{"type":"object","properties":{"publish":{"type":"string","examples":["Yes"]},"account_id":{"type":"integer","examples":[20101]},"account_url":{"type":"string","examples":["https://example.rosterfy.com/"]},"external":{"type":"boolean","examples":[false]},"has_certificate":{"type":"boolean","examples":[false]},"account_name_path":{"type":"string","examples":["Rosterfy Subaccount"]},"is_foreign_account":{"type":"boolean","examples":[false]},"acts_as_native":{"type":"boolean","examples":[false]},"number_of_steps":{"type":"string","examples":["3"]},"number_of_questions":{"type":"integer","examples":[0]}}},"relations":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}}},"examples":[[{"object":{"id":1,"name":"Site Safety Induction","short_description":null,"thumbnail_url":null,"account_id":20101,"deleted_at":null,"created_at":"2026-01-12T06:55:00.000000Z","updated_at":"2026-01-12T06:55:00.000000Z","success_message":"You have completed the induction.","is_archived":0,"is_elective":0,"estimated_complete_time":11,"ttl":0,"pass_score":0,"is_library":0,"publish":1,"service":"online","external_id":null,"meta":[],"sort_order":0,"certificate_id":null,"form_id":null,"type_id":null,"is_inheritable":0},"nice":{"publish":"Yes","account_id":20101,"account_url":"https://example.rosterfy.com/","external":false,"has_certificate":false,"account_name_path":"Rosterfy Subaccount","is_foreign_account":false,"acts_as_native":false,"number_of_steps":"3","number_of_questions":0},"relations":[],"permissions":{"read":true,"update":true,"delete":true}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}]]},"first_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/me/training?per_page=5&_locale=en-US&page=1"]},"from":{"type":"integer","examples":[1]},"next_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/me/training?per_page=5&_locale=en-US&page=2"]},"path":{"type":"string","examples":["https://example.rosterfy.com/api/v2/me/training"]},"per_page":{"type":"integer","examples":[5]},"prev_page_url":{"type":["string","null"],"examples":[null]},"to":{"type":"integer","examples":[5]}}},"examples":[[{"current_page":1,"data":[{"object":{"id":1,"name":"Site Safety Induction","short_description":null,"thumbnail_url":null,"account_id":20101,"deleted_at":null,"created_at":"2026-01-12T06:55:00.000000Z","updated_at":"2026-01-12T06:55:00.000000Z","success_message":"You have completed the induction.","is_archived":0,"is_elective":0,"estimated_complete_time":11,"ttl":0,"pass_score":0,"is_library":0,"publish":1,"service":"online","external_id":null,"meta":[],"sort_order":0,"certificate_id":null,"form_id":null,"type_id":null,"is_inheritable":0},"nice":{"publish":"Yes","account_id":20101,"account_url":"https://example.rosterfy.com/","external":false,"has_certificate":false,"account_name_path":"Rosterfy Subaccount","is_foreign_account":false,"acts_as_native":false,"number_of_steps":"3","number_of_questions":0},"relations":[],"permissions":{"read":true,"update":true,"delete":true}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}],"first_page_url":"https://example.rosterfy.com/api/v2/me/training?per_page=5&_locale=en-US&page=1","from":1,"next_page_url":"https://example.rosterfy.com/api/v2/me/training?per_page=5&_locale=en-US&page=2","path":"https://example.rosterfy.com/api/v2/me/training","per_page":5,"prev_page_url":null,"to":5}]]},"id":"schema_269"},"schema_270":{"kind":"json-schema","data":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Narrow the list by the user's involvement. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"active"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returns only"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"events where they hold a live place, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"demand"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" only events still looking for people. Any"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"other value is ignored and the full list is returned."},"children":[]}]}]}],"examples":["active"]},"id":"schema_270"},"schema_271":{"kind":"json-schema","data":{"type":"array","description":"A list of extras to include in the response. These are objects or arrays that are not part of\nthe model's primary attributes, such as stats and counts.\nFor fast responses, avoid requesting them if you don't need them. ","items":{"type":"string","enum":["leader_state","shift_count","stats","certificate_user_count"]},"examples":[["leader_state"]]},"id":"schema_271"},"schema_272":{"kind":"json-schema","data":{"type":"array","description":"A list of relations to include in the response. May be single records or collections.\nIt is often more efficient to retrieve this way, to avoid follow-up API calls.","items":{"type":"string","enum":["hasManyDeepFromRelationsWithConstraints","hasOneDeepFromRelationsWithConstraints","hasManyDeepFromReverse","hasOneDeepFromReverse"]},"examples":[["hasManyDeepFromRelationsWithConstraints"]]},"id":"schema_272"},"schema_273":{"kind":"json-schema","data":{"type":"array","items":{"type":"object","properties":{"current_page":{"type":"integer","examples":[1]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"parent_id":{"type":["string","null"],"examples":[null]},"event_template_id":{"type":["string","null"],"examples":[null]},"path":{"type":"string","examples":["21476346"]},"account_id":{"type":"integer","examples":[20101]},"event_type_id":{"type":"integer","examples":[11]},"journey_id":{"type":["string","null"],"examples":[null]},"timezone":{"type":"string","examples":["UTC"]},"start_timestamp":{"type":"string","examples":["2026-06-04T05:00:00.000000Z"]},"end_timestamp":{"type":"string","examples":["2026-06-29T05:00:00.000000Z"]},"is_ongoing":{"type":"integer","examples":[0]},"apps_open_timestamp":{"type":"string","examples":["2026-06-03T05:00:00.000000Z"]},"apps_close_timestamp":{"type":"string","examples":["2026-06-07T05:00:00.000000Z"]},"headcount_location_venue_id":{"type":["string","null"],"examples":[null]},"headcount_functional_area_job_title_id":{"type":["string","null"],"examples":[null]},"shift_status_default":{"type":"integer","examples":[2]},"max_shift_apps_per_user":{"type":"integer","examples":[0]},"min_shift_apps_per_user":{"type":"integer","examples":[0]},"min_shift_apps_per_shift_type":{"type":["string","null"],"examples":[null]},"max_shift_apps_per_shift_type":{"type":["string","null"],"examples":[null]},"gap_between_shifts":{"type":"integer","examples":[0]},"shift_confirmed_status_default":{"type":"integer","examples":[3]},"shift_rejected_status_default":{"type":"integer","examples":[6]},"shift_can_withdraw_default":{"type":"integer","examples":[1]},"shift_can_confirm_default":{"type":"integer","examples":[1]},"shift_can_confirm_limit":{"type":"integer","examples":[0]},"shift_can_withdraw_limit":{"type":"integer","examples":[0]},"shift_checked_in_status_default":{"type":"integer","examples":[4]},"shift_checked_out_status_default":{"type":"integer","examples":[4]},"certificate_id":{"type":["string","null"],"examples":[null]},"shift_application_form_id_default":{"type":["string","null"],"examples":[null]},"shift_withdraw_form_id_default":{"type":["string","null"],"examples":[null]},"shift_checkin_form_id_default":{"type":["string","null"],"examples":[null]},"shift_attended_form_id_default":{"type":["string","null"],"examples":[null]},"shift_checkout_form_id_default":{"type":["string","null"],"examples":[null]},"shift_leader_feedback_form_id_default":{"type":["string","null"],"examples":[null]},"shift_feedback_form_id_default":{"type":["string","null"],"examples":[null]},"shift_precheckin_form_id_default":{"type":["string","null"],"examples":[null]},"shift_default_journey_complete_status":{"type":["string","null"],"examples":[null]},"shift_default_journey_id":{"type":["string","null"],"examples":[null]},"allow_user_activities":{"type":"integer","examples":[0]},"user_activity_form_id":{"type":["string","null"],"examples":[null]},"training_ids":{"type":["string","null"],"examples":[null]},"banner_image":{"type":["string","null"],"examples":[null]},"grid_image":{"type":["string","null"],"examples":[null]},"minimum_dob":{"type":["string","null"],"examples":[null]},"minimum_age":{"type":["string","null"],"examples":[null]},"maximum_dob":{"type":["string","null"],"examples":[null]},"maximum_age":{"type":["string","null"],"examples":[null]},"visibility_show_groups":{"type":"array","examples":[[]]},"visibility_hide_groups":{"type":"array","examples":[[]]},"visibility_show_roleoffer":{"type":"array","examples":[[]]},"role_offer_address":{"type":"integer","examples":[0]},"checkin_visible_attributes":{"type":"array","examples":[[]]},"shift_filter_attributes":{"type":["string","null"],"examples":[null]},"leader_shift_filter_attributes":{"type":["string","null"],"examples":[null]},"self_checkin":{"type":"integer","examples":[0]},"self_checkin_open":{"type":"integer","examples":[0]},"self_checkin_close":{"type":"integer","examples":[0]},"self_checkout_close":{"type":"integer","examples":[0]},"checkin_close_default":{"type":"integer","examples":[0]},"shift_precheckin_open_default":{"type":["string","null"],"examples":[null]},"shift_enable_waitlist_default":{"type":"integer","examples":[0]},"geofence_checkin_limit_default":{"type":["string","null"],"examples":[null]},"max_waitlist":{"type":"integer","examples":[0]},"group_booking_ttl_default":{"type":["string","null"],"examples":[null]},"max_group_demand_default":{"type":["string","null"],"examples":[null]},"max_group_size":{"type":["string","null"],"examples":[null]},"reserved_expiry":{"type":["string","null"],"examples":[null]},"post_feedback_form":{"type":["string","null"],"examples":[null]},"post_feedback_publish_at":{"type":["string","null"],"examples":[null]},"expression_of_interest":{"type":"integer","examples":[0]},"journey_complete_status":{"type":["string","null"],"examples":[null]},"journey_apply_status":{"type":["string","null"],"examples":[null]},"expression_of_interest_form":{"type":["string","null"],"examples":[null]},"cancel_expression_of_interest_form_id":{"type":["string","null"],"examples":[null]},"eoi_demand":{"type":"integer","examples":[0]},"sort_order":{"type":"integer","examples":[0]},"is_virtual":{"type":"integer","examples":[0]},"status":{"type":"string","examples":["published"]},"approval_status":{"type":"string","examples":["approved"]},"approval_reason":{"type":["string","null"],"examples":[null]},"promoted":{"type":"integer","examples":[0]},"public":{"type":"integer","examples":[0]},"is_cancelled":{"type":"integer","examples":[0]},"is_archived":{"type":"integer","examples":[0]},"public_shift":{"type":"integer","examples":[0]},"public_shift_default":{"type":"integer","examples":[0]},"certificates_awarded":{"type":"integer","examples":[0]},"created_by":{"type":"integer","examples":[1234]},"updated_by":{"type":"integer","examples":[1234]},"deleted_at":{"type":["string","null"],"examples":[null]},"is_erased":{"type":"integer","examples":[0]},"created_at":{"type":"string","examples":["2026-06-09T05:36:50.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:50.000000Z"]},"deleted_by":{"type":["string","null"],"examples":[null]},"description":{"type":"string","examples":["<p>Our flagship community event.</p>"]},"name":{"type":"string","examples":["City Marathon 2026"]},"address":{"type":"object","properties":{"iso":{"type":"string","examples":["AUS"]},"street_address_1":{"type":"string","examples":["1 Example Street"]},"street_address_2":{"type":["string","null"],"examples":[null]},"street_address_3":{"type":["string","null"],"examples":[null]},"city":{"type":"string","examples":["Example City"]},"postcode":{"type":"string","examples":["1000"]},"region":{"type":"string","examples":["VIC"]},"country":{"type":"string","examples":["AU"]},"latitude":{"type":["string","null"],"examples":[null]},"longitude":{"type":["string","null"],"examples":[null]}}}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:event:1"]},"allow_user_activities":{"type":"string","examples":["No"]},"approval_status":{"type":"string","examples":["Approved"]},"approval_status:value":{"type":"string","examples":["approved"]},"approval_status:array":{"type":"string","examples":["Approved"]},"apps_close_timestamp":{"type":"string","examples":["Jun 7, 2026, 5:00 AM"]},"apps_close_timestamp__date":{"type":"string","examples":["Jun 7, 2026"]},"apps_close_timestamp__time":{"type":"string","examples":["5:00 AM"]},"apps_close_timestamp__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"apps_close_timestamp__offset_minutes":{"type":"integer","examples":[0]},"apps_close_timestamp__dayofweek":{"type":"string","examples":["Sunday"]},"apps_open_timestamp":{"type":"string","examples":["Jun 3, 2026, 5:00 AM"]},"apps_open_timestamp__date":{"type":"string","examples":["Jun 3, 2026"]},"apps_open_timestamp__time":{"type":"string","examples":["5:00 AM"]},"apps_open_timestamp__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"apps_open_timestamp__offset_minutes":{"type":"integer","examples":[0]},"apps_open_timestamp__dayofweek":{"type":"string","examples":["Wednesday"]},"cancel_expression_of_interest_form_id":{"type":["string","null"],"examples":[null]},"cancel_expression_of_interest_form_id:value":{"type":["string","null"],"examples":[null]},"cancel_expression_of_interest_form_id:array":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["Jun 9, 2026, 5:36 AM"]},"created_at__date":{"type":"string","examples":["Jun 9, 2026"]},"created_at__time":{"type":"string","examples":["5:36 AM"]},"created_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"created_at__offset_minutes":{"type":"integer","examples":[0]},"created_at__dayofweek":{"type":"string","examples":["Tuesday"]},"end_timestamp":{"type":"string","examples":["Jun 29, 2026, 5:00 AM"]},"end_timestamp__date":{"type":"string","examples":["Jun 29, 2026"]},"end_timestamp__time":{"type":"string","examples":["5:00 AM"]},"end_timestamp__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"end_timestamp__offset_minutes":{"type":"integer","examples":[0]},"end_timestamp__dayofweek":{"type":"string","examples":["Monday"]},"event_template_id":{"type":["string","null"],"examples":[null]},"event_template_id:value":{"type":["string","null"],"examples":[null]},"event_template_id:array":{"type":["string","null"],"examples":[null]},"event_type_id":{"type":"string","examples":["ratione laborum dolor"]},"event_type_id:value":{"type":"integer","examples":[11]},"event_type_id:array":{"type":"string","examples":["ratione laborum dolor"]},"expression_of_interest":{"type":"string","examples":["No"]},"headcount_location_venue_id":{"type":["string","null"],"examples":[null]},"headcount_location_venue_id:value":{"type":["string","null"],"examples":[null]},"headcount_location_venue_id:array":{"type":["string","null"],"examples":[null]},"is_ongoing":{"type":"string","examples":["No"]},"is_virtual":{"type":"string","examples":["No"]},"name":{"type":"string","examples":["City Marathon 2026"]},"promoted":{"type":"string","examples":["No"]},"role_offer_address":{"type":"string","examples":["No"]},"self_checkin":{"type":"string","examples":["No"]},"shift_application_form_id_default":{"type":["string","null"],"examples":[null]},"shift_application_form_id_default:value":{"type":["string","null"],"examples":[null]},"shift_application_form_id_default:array":{"type":["string","null"],"examples":[null]},"shift_attended_form_id_default":{"type":["string","null"],"examples":[null]},"shift_attended_form_id_default:value":{"type":["string","null"],"examples":[null]},"shift_attended_form_id_default:array":{"type":["string","null"],"examples":[null]},"shift_checkin_form_id_default":{"type":["string","null"],"examples":[null]},"shift_checkin_form_id_default:value":{"type":["string","null"],"examples":[null]},"shift_checkin_form_id_default:array":{"type":["string","null"],"examples":[null]},"shift_checkout_form_id_default":{"type":["string","null"],"examples":[null]},"shift_checkout_form_id_default:value":{"type":["string","null"],"examples":[null]},"shift_checkout_form_id_default:array":{"type":["string","null"],"examples":[null]},"shift_feedback_form_id_default":{"type":["string","null"],"examples":[null]},"shift_feedback_form_id_default:value":{"type":["string","null"],"examples":[null]},"shift_feedback_form_id_default:array":{"type":["string","null"],"examples":[null]},"shift_precheckin_form_id_default":{"type":["string","null"],"examples":[null]},"shift_precheckin_form_id_default:value":{"type":["string","null"],"examples":[null]},"shift_precheckin_form_id_default:array":{"type":["string","null"],"examples":[null]},"shift_withdraw_form_id_default":{"type":["string","null"],"examples":[null]},"shift_withdraw_form_id_default:value":{"type":["string","null"],"examples":[null]},"shift_withdraw_form_id_default:array":{"type":["string","null"],"examples":[null]},"start_timestamp":{"type":"string","examples":["Jun 4, 2026, 5:00 AM"]},"start_timestamp__date":{"type":"string","examples":["Jun 4, 2026"]},"start_timestamp__time":{"type":"string","examples":["5:00 AM"]},"start_timestamp__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"start_timestamp__offset_minutes":{"type":"integer","examples":[0]},"start_timestamp__dayofweek":{"type":"string","examples":["Thursday"]},"status":{"type":"string","examples":["Published"]},"status:value":{"type":"string","examples":["published"]},"status:array":{"type":"string","examples":["Published"]},"tags":{"type":["string","null"],"examples":[null]},"tags:value":{"type":["string","null"],"examples":[null]},"tags:array":{"type":["string","null"],"examples":[null]},"updated_at":{"type":"string","examples":["Jun 9, 2026, 5:36 AM"]},"updated_at__date":{"type":"string","examples":["Jun 9, 2026"]},"updated_at__time":{"type":"string","examples":["5:36 AM"]},"updated_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"updated_at__offset_minutes":{"type":"integer","examples":[0]},"updated_at__dayofweek":{"type":"string","examples":["Tuesday"]},"visibility_hide_groups":{"type":"string","examples":[""]},"visibility_show_groups":{"type":"string","examples":[""]},"visibility_show_roleoffer":{"type":"string","examples":[""]},"full_name":{"type":"string","examples":["City Marathon 2026"]},"event_type_name":{"type":"string","examples":["ratione laborum dolor"]},"grid_list_image":{"type":["string","null"],"examples":[null]},"is_eoi_demand_met":{"type":"boolean","examples":[false]},"has_payrun":{"type":"boolean","examples":[false]},"min_shifts":{"type":"integer","examples":[0]},"post_event_feedback_form_completed_at":{"type":["string","null"],"examples":[null]},"expression_of_interest_form_completed_at":{"type":["string","null"],"examples":[null]},"expression_of_interest_form_cancelled_at":{"type":["string","null"],"examples":[null]},"account_name":{"type":"string","examples":["Example Organisation"]},"apply":{"type":"object","properties":{"code":{"type":"integer","examples":[1001]},"message":{"type":"string","examples":["Event is closed"]}}},"address":{"type":"string","examples":["1 Example Street\nExample City\nVictoria\nAustralia\n1000"]},"address_oneline":{"type":"string","examples":["1 Example Street, Example City, Victoria, Australia, 1000"]},"address.latitude":{"type":["string","null"],"examples":[null]},"address.longitude":{"type":["string","null"],"examples":[null]}}},"relations":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]},"apply":{"type":"boolean","examples":[false]},"cancel":{"type":"boolean","examples":[false]},"can_publish":{"type":"boolean","examples":[true]}}},"attributes":{"type":"array","examples":[[]]}}},"examples":[[{"object":{"id":1,"parent_id":null,"event_template_id":null,"path":"21476346","account_id":20101,"event_type_id":11,"journey_id":null,"timezone":"UTC","start_timestamp":"2026-06-04T05:00:00.000000Z","end_timestamp":"2026-06-29T05:00:00.000000Z","is_ongoing":0,"apps_open_timestamp":"2026-06-03T05:00:00.000000Z","apps_close_timestamp":"2026-06-07T05:00:00.000000Z","headcount_location_venue_id":null,"headcount_functional_area_job_title_id":null,"shift_status_default":2,"max_shift_apps_per_user":0,"min_shift_apps_per_user":0,"min_shift_apps_per_shift_type":null,"max_shift_apps_per_shift_type":null,"gap_between_shifts":0,"shift_confirmed_status_default":3,"shift_rejected_status_default":6,"shift_can_withdraw_default":1,"shift_can_confirm_default":1,"shift_can_confirm_limit":0,"shift_can_withdraw_limit":0,"shift_checked_in_status_default":4,"shift_checked_out_status_default":4,"certificate_id":null,"shift_application_form_id_default":null,"shift_withdraw_form_id_default":null,"shift_checkin_form_id_default":null,"shift_attended_form_id_default":null,"shift_checkout_form_id_default":null,"shift_leader_feedback_form_id_default":null,"shift_feedback_form_id_default":null,"shift_precheckin_form_id_default":null,"shift_default_journey_complete_status":null,"shift_default_journey_id":null,"allow_user_activities":0,"user_activity_form_id":null,"training_ids":null,"banner_image":null,"grid_image":null,"minimum_dob":null,"minimum_age":null,"maximum_dob":null,"maximum_age":null,"visibility_show_groups":[],"visibility_hide_groups":[],"visibility_show_roleoffer":[],"role_offer_address":0,"checkin_visible_attributes":[],"shift_filter_attributes":null,"leader_shift_filter_attributes":null,"self_checkin":0,"self_checkin_open":0,"self_checkin_close":0,"self_checkout_close":0,"checkin_close_default":0,"shift_precheckin_open_default":null,"shift_enable_waitlist_default":0,"geofence_checkin_limit_default":null,"max_waitlist":0,"group_booking_ttl_default":null,"max_group_demand_default":null,"max_group_size":null,"reserved_expiry":null,"post_feedback_form":null,"post_feedback_publish_at":null,"expression_of_interest":0,"journey_complete_status":null,"journey_apply_status":null,"expression_of_interest_form":null,"cancel_expression_of_interest_form_id":null,"eoi_demand":0,"sort_order":0,"is_virtual":0,"status":"published","approval_status":"approved","approval_reason":null,"promoted":0,"public":0,"is_cancelled":0,"is_archived":0,"public_shift":0,"public_shift_default":0,"certificates_awarded":0,"created_by":1234,"updated_by":1234,"deleted_at":null,"is_erased":0,"created_at":"2026-06-09T05:36:50.000000Z","updated_at":"2026-06-09T05:36:50.000000Z","deleted_by":null,"description":"<p>Our flagship community event.</p>","name":"City Marathon 2026","address":{"iso":"AUS","street_address_1":"1 Example Street","street_address_2":null,"street_address_3":null,"city":"Example City","postcode":"1000","region":"VIC","country":"AU","latitude":null,"longitude":null}},"nice":{"rrn":"rrn:local:20101:event:1","allow_user_activities":"No","approval_status":"Approved","approval_status:value":"approved","approval_status:array":"Approved","apps_close_timestamp":"Jun 7, 2026, 5:00 AM","apps_close_timestamp__date":"Jun 7, 2026","apps_close_timestamp__time":"5:00 AM","apps_close_timestamp__offset":" (+00:00 UTC)","apps_close_timestamp__offset_minutes":0,"apps_close_timestamp__dayofweek":"Sunday","apps_open_timestamp":"Jun 3, 2026, 5:00 AM","apps_open_timestamp__date":"Jun 3, 2026","apps_open_timestamp__time":"5:00 AM","apps_open_timestamp__offset":" (+00:00 UTC)","apps_open_timestamp__offset_minutes":0,"apps_open_timestamp__dayofweek":"Wednesday","cancel_expression_of_interest_form_id":null,"cancel_expression_of_interest_form_id:value":null,"cancel_expression_of_interest_form_id:array":null,"created_at":"Jun 9, 2026, 5:36 AM","created_at__date":"Jun 9, 2026","created_at__time":"5:36 AM","created_at__offset":" (+00:00 UTC)","created_at__offset_minutes":0,"created_at__dayofweek":"Tuesday","end_timestamp":"Jun 29, 2026, 5:00 AM","end_timestamp__date":"Jun 29, 2026","end_timestamp__time":"5:00 AM","end_timestamp__offset":" (+00:00 UTC)","end_timestamp__offset_minutes":0,"end_timestamp__dayofweek":"Monday","event_template_id":null,"event_template_id:value":null,"event_template_id:array":null,"event_type_id":"ratione laborum dolor","event_type_id:value":11,"event_type_id:array":"ratione laborum dolor","expression_of_interest":"No","headcount_location_venue_id":null,"headcount_location_venue_id:value":null,"headcount_location_venue_id:array":null,"is_ongoing":"No","is_virtual":"No","name":"City Marathon 2026","promoted":"No","role_offer_address":"No","self_checkin":"No","shift_application_form_id_default":null,"shift_application_form_id_default:value":null,"shift_application_form_id_default:array":null,"shift_attended_form_id_default":null,"shift_attended_form_id_default:value":null,"shift_attended_form_id_default:array":null,"shift_checkin_form_id_default":null,"shift_checkin_form_id_default:value":null,"shift_checkin_form_id_default:array":null,"shift_checkout_form_id_default":null,"shift_checkout_form_id_default:value":null,"shift_checkout_form_id_default:array":null,"shift_feedback_form_id_default":null,"shift_feedback_form_id_default:value":null,"shift_feedback_form_id_default:array":null,"shift_precheckin_form_id_default":null,"shift_precheckin_form_id_default:value":null,"shift_precheckin_form_id_default:array":null,"shift_withdraw_form_id_default":null,"shift_withdraw_form_id_default:value":null,"shift_withdraw_form_id_default:array":null,"start_timestamp":"Jun 4, 2026, 5:00 AM","start_timestamp__date":"Jun 4, 2026","start_timestamp__time":"5:00 AM","start_timestamp__offset":" (+00:00 UTC)","start_timestamp__offset_minutes":0,"start_timestamp__dayofweek":"Thursday","status":"Published","status:value":"published","status:array":"Published","tags":null,"tags:value":null,"tags:array":null,"updated_at":"Jun 9, 2026, 5:36 AM","updated_at__date":"Jun 9, 2026","updated_at__time":"5:36 AM","updated_at__offset":" (+00:00 UTC)","updated_at__offset_minutes":0,"updated_at__dayofweek":"Tuesday","visibility_hide_groups":"","visibility_show_groups":"","visibility_show_roleoffer":"","full_name":"City Marathon 2026","event_type_name":"ratione laborum dolor","grid_list_image":null,"is_eoi_demand_met":false,"has_payrun":false,"min_shifts":0,"post_event_feedback_form_completed_at":null,"expression_of_interest_form_completed_at":null,"expression_of_interest_form_cancelled_at":null,"account_name":"Example Organisation","apply":{"code":1001,"message":"Event is closed"},"address":"1 Example Street\nExample City\nVictoria\nAustralia\n1000","address_oneline":"1 Example Street, Example City, Victoria, Australia, 1000","address.latitude":null,"address.longitude":null},"relations":[],"permissions":{"read":true,"update":true,"delete":true,"apply":false,"cancel":false,"can_publish":true},"attributes":[]},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}]]},"first_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/me/event?per_page=5&_locale=en-US&page=1"]},"from":{"type":"integer","examples":[1]},"next_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/me/event?per_page=5&_locale=en-US&page=2"]},"path":{"type":"string","examples":["https://example.rosterfy.com/api/v2/me/event"]},"per_page":{"type":"integer","examples":[5]},"prev_page_url":{"type":["string","null"],"examples":[null]},"to":{"type":"integer","examples":[5]}}},"examples":[[{"current_page":1,"data":[{"object":{"id":1,"parent_id":null,"event_template_id":null,"path":"21476346","account_id":20101,"event_type_id":11,"journey_id":null,"timezone":"UTC","start_timestamp":"2026-06-04T05:00:00.000000Z","end_timestamp":"2026-06-29T05:00:00.000000Z","is_ongoing":0,"apps_open_timestamp":"2026-06-03T05:00:00.000000Z","apps_close_timestamp":"2026-06-07T05:00:00.000000Z","headcount_location_venue_id":null,"headcount_functional_area_job_title_id":null,"shift_status_default":2,"max_shift_apps_per_user":0,"min_shift_apps_per_user":0,"min_shift_apps_per_shift_type":null,"max_shift_apps_per_shift_type":null,"gap_between_shifts":0,"shift_confirmed_status_default":3,"shift_rejected_status_default":6,"shift_can_withdraw_default":1,"shift_can_confirm_default":1,"shift_can_confirm_limit":0,"shift_can_withdraw_limit":0,"shift_checked_in_status_default":4,"shift_checked_out_status_default":4,"certificate_id":null,"shift_application_form_id_default":null,"shift_withdraw_form_id_default":null,"shift_checkin_form_id_default":null,"shift_attended_form_id_default":null,"shift_checkout_form_id_default":null,"shift_leader_feedback_form_id_default":null,"shift_feedback_form_id_default":null,"shift_precheckin_form_id_default":null,"shift_default_journey_complete_status":null,"shift_default_journey_id":null,"allow_user_activities":0,"user_activity_form_id":null,"training_ids":null,"banner_image":null,"grid_image":null,"minimum_dob":null,"minimum_age":null,"maximum_dob":null,"maximum_age":null,"visibility_show_groups":[],"visibility_hide_groups":[],"visibility_show_roleoffer":[],"role_offer_address":0,"checkin_visible_attributes":[],"shift_filter_attributes":null,"leader_shift_filter_attributes":null,"self_checkin":0,"self_checkin_open":0,"self_checkin_close":0,"self_checkout_close":0,"checkin_close_default":0,"shift_precheckin_open_default":null,"shift_enable_waitlist_default":0,"geofence_checkin_limit_default":null,"max_waitlist":0,"group_booking_ttl_default":null,"max_group_demand_default":null,"max_group_size":null,"reserved_expiry":null,"post_feedback_form":null,"post_feedback_publish_at":null,"expression_of_interest":0,"journey_complete_status":null,"journey_apply_status":null,"expression_of_interest_form":null,"cancel_expression_of_interest_form_id":null,"eoi_demand":0,"sort_order":0,"is_virtual":0,"status":"published","approval_status":"approved","approval_reason":null,"promoted":0,"public":0,"is_cancelled":0,"is_archived":0,"public_shift":0,"public_shift_default":0,"certificates_awarded":0,"created_by":1234,"updated_by":1234,"deleted_at":null,"is_erased":0,"created_at":"2026-06-09T05:36:50.000000Z","updated_at":"2026-06-09T05:36:50.000000Z","deleted_by":null,"description":"<p>Our flagship community event.</p>","name":"City Marathon 2026","address":{"iso":"AUS","street_address_1":"1 Example Street","street_address_2":null,"street_address_3":null,"city":"Example City","postcode":"1000","region":"VIC","country":"AU","latitude":null,"longitude":null}},"nice":{"rrn":"rrn:local:20101:event:1","allow_user_activities":"No","approval_status":"Approved","approval_status:value":"approved","approval_status:array":"Approved","apps_close_timestamp":"Jun 7, 2026, 5:00 AM","apps_close_timestamp__date":"Jun 7, 2026","apps_close_timestamp__time":"5:00 AM","apps_close_timestamp__offset":" (+00:00 UTC)","apps_close_timestamp__offset_minutes":0,"apps_close_timestamp__dayofweek":"Sunday","apps_open_timestamp":"Jun 3, 2026, 5:00 AM","apps_open_timestamp__date":"Jun 3, 2026","apps_open_timestamp__time":"5:00 AM","apps_open_timestamp__offset":" (+00:00 UTC)","apps_open_timestamp__offset_minutes":0,"apps_open_timestamp__dayofweek":"Wednesday","cancel_expression_of_interest_form_id":null,"cancel_expression_of_interest_form_id:value":null,"cancel_expression_of_interest_form_id:array":null,"created_at":"Jun 9, 2026, 5:36 AM","created_at__date":"Jun 9, 2026","created_at__time":"5:36 AM","created_at__offset":" (+00:00 UTC)","created_at__offset_minutes":0,"created_at__dayofweek":"Tuesday","end_timestamp":"Jun 29, 2026, 5:00 AM","end_timestamp__date":"Jun 29, 2026","end_timestamp__time":"5:00 AM","end_timestamp__offset":" (+00:00 UTC)","end_timestamp__offset_minutes":0,"end_timestamp__dayofweek":"Monday","event_template_id":null,"event_template_id:value":null,"event_template_id:array":null,"event_type_id":"ratione laborum dolor","event_type_id:value":11,"event_type_id:array":"ratione laborum dolor","expression_of_interest":"No","headcount_location_venue_id":null,"headcount_location_venue_id:value":null,"headcount_location_venue_id:array":null,"is_ongoing":"No","is_virtual":"No","name":"City Marathon 2026","promoted":"No","role_offer_address":"No","self_checkin":"No","shift_application_form_id_default":null,"shift_application_form_id_default:value":null,"shift_application_form_id_default:array":null,"shift_attended_form_id_default":null,"shift_attended_form_id_default:value":null,"shift_attended_form_id_default:array":null,"shift_checkin_form_id_default":null,"shift_checkin_form_id_default:value":null,"shift_checkin_form_id_default:array":null,"shift_checkout_form_id_default":null,"shift_checkout_form_id_default:value":null,"shift_checkout_form_id_default:array":null,"shift_feedback_form_id_default":null,"shift_feedback_form_id_default:value":null,"shift_feedback_form_id_default:array":null,"shift_precheckin_form_id_default":null,"shift_precheckin_form_id_default:value":null,"shift_precheckin_form_id_default:array":null,"shift_withdraw_form_id_default":null,"shift_withdraw_form_id_default:value":null,"shift_withdraw_form_id_default:array":null,"start_timestamp":"Jun 4, 2026, 5:00 AM","start_timestamp__date":"Jun 4, 2026","start_timestamp__time":"5:00 AM","start_timestamp__offset":" (+00:00 UTC)","start_timestamp__offset_minutes":0,"start_timestamp__dayofweek":"Thursday","status":"Published","status:value":"published","status:array":"Published","tags":null,"tags:value":null,"tags:array":null,"updated_at":"Jun 9, 2026, 5:36 AM","updated_at__date":"Jun 9, 2026","updated_at__time":"5:36 AM","updated_at__offset":" (+00:00 UTC)","updated_at__offset_minutes":0,"updated_at__dayofweek":"Tuesday","visibility_hide_groups":"","visibility_show_groups":"","visibility_show_roleoffer":"","full_name":"City Marathon 2026","event_type_name":"ratione laborum dolor","grid_list_image":null,"is_eoi_demand_met":false,"has_payrun":false,"min_shifts":0,"post_event_feedback_form_completed_at":null,"expression_of_interest_form_completed_at":null,"expression_of_interest_form_cancelled_at":null,"account_name":"Example Organisation","apply":{"code":1001,"message":"Event is closed"},"address":"1 Example Street\nExample City\nVictoria\nAustralia\n1000","address_oneline":"1 Example Street, Example City, Victoria, Australia, 1000","address.latitude":null,"address.longitude":null},"relations":[],"permissions":{"read":true,"update":true,"delete":true,"apply":false,"cancel":false,"can_publish":true},"attributes":[]},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}],"first_page_url":"https://example.rosterfy.com/api/v2/me/event?per_page=5&_locale=en-US&page=1","from":1,"next_page_url":"https://example.rosterfy.com/api/v2/me/event?per_page=5&_locale=en-US&page=2","path":"https://example.rosterfy.com/api/v2/me/event","per_page":5,"prev_page_url":null,"to":5}]]},"id":"schema_273"},"schema_274":{"kind":"json-schema","data":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return the user's own allocations ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", the default) or"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the catalogue of items they are eligible for ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). The two return different shapes."},"children":[]}]}]}],"examples":[true]},"id":"schema_274"},"schema_275":{"kind":"json-schema","data":{"type":"array","items":{"type":"object","properties":{"current_page":{"type":"integer","examples":[1]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"inventory_allocation_id":{"type":["string","null"],"examples":[null]},"inventory_item_id":{"type":"integer","examples":[1]},"user_id":{"type":"integer","examples":[1234]},"entity":{"type":["string","null"],"examples":[null]},"entity_id":{"type":["string","null"],"examples":[null]},"inventory_allocation_type":{"type":"string","examples":["rewards"]},"serial":{"type":["string","null"],"examples":[null]},"inventory_item_serial_id":{"type":["string","null"],"examples":[null]},"expires_at":{"type":["string","null"],"examples":[null]},"collected_at":{"type":["string","null"],"examples":[null]},"collected_entity":{"type":["string","null"],"examples":[null]},"collected_by":{"type":["string","null"],"examples":[null]},"data":{"type":["string","null"],"examples":[null]},"sort_order":{"type":"integer","examples":[0]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-01-15T04:12:07.000000Z"]},"updated_at":{"type":"string","examples":["2026-01-15T04:12:07.000000Z"]}}},"nice":{"type":"object","properties":{"inventory_allocation_type":{"type":"string","examples":["Rewards"]},"user_name":{"type":"string","examples":["Alex Example"]}}},"relations":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]},"user_update":{"type":"boolean","examples":[true]}}}}},"examples":[[{"object":{"id":1,"inventory_allocation_id":null,"inventory_item_id":1,"user_id":1234,"entity":null,"entity_id":null,"inventory_allocation_type":"rewards","serial":null,"inventory_item_serial_id":null,"expires_at":null,"collected_at":null,"collected_entity":null,"collected_by":null,"data":null,"sort_order":0,"deleted_at":null,"created_at":"2026-01-15T04:12:07.000000Z","updated_at":"2026-01-15T04:12:07.000000Z"},"nice":{"inventory_allocation_type":"Rewards","user_name":"Alex Example"},"relations":[],"permissions":{"read":true,"update":true,"delete":true,"user_update":true}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}]]},"first_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/me/inventory/item?per_page=5&_locale=en-US&page=1"]},"from":{"type":"integer","examples":[1]},"next_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/me/inventory/item?per_page=5&_locale=en-US&page=2"]},"path":{"type":"string","examples":["https://example.rosterfy.com/api/v2/me/inventory/item"]},"per_page":{"type":"integer","examples":[5]},"prev_page_url":{"type":["string","null"],"examples":[null]},"to":{"type":"integer","examples":[5]}}},"examples":[[{"current_page":1,"data":[{"object":{"id":1,"inventory_allocation_id":null,"inventory_item_id":1,"user_id":1234,"entity":null,"entity_id":null,"inventory_allocation_type":"rewards","serial":null,"inventory_item_serial_id":null,"expires_at":null,"collected_at":null,"collected_entity":null,"collected_by":null,"data":null,"sort_order":0,"deleted_at":null,"created_at":"2026-01-15T04:12:07.000000Z","updated_at":"2026-01-15T04:12:07.000000Z"},"nice":{"inventory_allocation_type":"Rewards","user_name":"Alex Example"},"relations":[],"permissions":{"read":true,"update":true,"delete":true,"user_update":true}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}],"first_page_url":"https://example.rosterfy.com/api/v2/me/inventory/item?per_page=5&_locale=en-US&page=1","from":1,"next_page_url":"https://example.rosterfy.com/api/v2/me/inventory/item?per_page=5&_locale=en-US&page=2","path":"https://example.rosterfy.com/api/v2/me/inventory/item","per_page":5,"prev_page_url":null,"to":5}]]},"id":"schema_275"},"schema_276":{"kind":"json-schema","data":{"type":"object","properties":{"balance":{"type":"integer","examples":[1000]}},"examples":[{"balance":1000}]},"id":"schema_276"},"schema_277":{"kind":"json-schema","data":{"type":"array","description":"A list of extras to include in the response. These are objects or arrays that are not part of\nthe model's primary attributes, such as stats and counts.\nFor fast responses, avoid requesting them if you don't need them. ","items":{"type":"string","enum":["duplicate_status","crm","background_check_user","login_locked","availability","google2fa","high_accessibility","locale","timezone","shift_hours_by_event_type","shift_hours_by_event_type_as_string","first_shift","first_shift_date","last_shift","last_shift_date","push_notifications"]},"examples":[["duplicate_status"]]},"id":"schema_277"},"schema_278":{"kind":"json-schema","data":{"type":"array","description":"A list of relations to include in the response. May be single records or collections.\nIt is often more efficient to retrieve this way, to avoid follow-up API calls.","items":{"type":"string","enum":["address","account","user_checkpoints","user_checkpoint","checkpoint","vendor_id","entity_vendor_id","user_type","type","account_roles","training_completed","training_incomplete","event_feedback_completed","role_offer_demand","role_offer_with_demand_status","role_offer_viable","role_offer_pending","role_offer_accepted","role_offer_rejected","background_check_user","invitation_submitted","form_submissions","admin_submissions","event_shift_applied","event_shift_confirmed","event_shift_rejected","event_shift_attended","event_attended","event_activity_attended","items","certificates","messaging_tandc_acceptance"]},"examples":[["address"]]},"id":"schema_278"},"schema_279":{"kind":"json-schema","data":{"type":"array","items":{"type":"object","properties":{"current_page":{"type":"integer","examples":[1]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[23453479]},"id_token":{"type":"string","examples":["xxxxxxxxxxxxxxxxxxxxxxxx"]},"account_id":{"type":"integer","examples":[20101]},"email":{"type":"string","examples":["alex.taylor@example.com"]},"force_reset_password":{"type":"integer","examples":[0]},"password_expires_at":{"type":["string","null"],"examples":[null]},"first_name":{"type":"string","examples":["Alex"]},"middle_name":{"type":["string","null"],"examples":[null]},"last_name":{"type":"string","examples":["Taylor"]},"preferred_name":{"type":["string","null"],"examples":[null]},"phone":{"type":"string","examples":["au-390000000"]},"dob":{"type":"string","examples":["1990-04-12"]},"picture":{"type":["string","null"],"examples":[null]},"picture_status":{"type":"integer","examples":[0]},"is_subscribed":{"type":"integer","examples":[0]},"is_subscribed_transactional":{"type":"integer","examples":[1]},"is_unreachable":{"type":"integer","examples":[0]},"is_unreachable_sms":{"type":"integer","examples":[0]},"terms":{"type":"integer","examples":[1]},"rating":{"type":"string","examples":["0.00"]},"shift_privacy":{"type":"integer","examples":[1]},"is_team_leader":{"type":"integer","examples":[0]},"email_verified":{"type":"integer","examples":[0]},"login_lockout_attempts":{"type":"integer","examples":[0]},"login_lockout_at":{"type":["string","null"],"examples":[null]},"login_lockout_email_sent_at":{"type":["string","null"],"examples":[null]},"last_login_at":{"type":["string","null"],"examples":[null]},"last_app_login_at":{"type":["string","null"],"examples":[null]},"is_archived":{"type":"integer","examples":[0]},"last_activated":{"type":["string","null"],"examples":[null]},"from_source":{"type":["string","null"],"examples":[null]},"delete_requested_at":{"type":["string","null"],"examples":[null]},"deleted_at":{"type":["string","null"],"examples":[null]},"is_erased":{"type":"integer","examples":[0]},"created_at":{"type":"string","examples":["2026-05-29T18:30:58.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:35:38.000000Z"]},"deleted_by":{"type":["string","null"],"examples":[null]},"interests":{"type":["string","null"],"examples":[null]},"address":{"type":"object","properties":{"iso":{"type":"string","examples":["AUS"]},"region_code":{"type":"string","examples":["VIC"]},"coordinates":{"type":"object","properties":{"latitude":{"type":"string","examples":["-37.814000"]},"longitude":{"type":"string","examples":["144.963200"]}}},"street_address_1":{"type":"string","examples":["1 Example Street"]},"street_address_2":{"type":["string","null"],"examples":[null]},"street_address_3":{"type":["string","null"],"examples":[null]},"city":{"type":"string","examples":["Melbourne"]},"postcode":{"type":"string","examples":["3000"]},"region":{"type":"string","examples":["VIC"]},"country":{"type":"string","examples":["AU"]},"latitude":{"type":"string","examples":["-37.814000"]},"longitude":{"type":"string","examples":["144.963200"]}}}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:user:xxxxxxxxxxxxxxxxxxxxxxxx"]},"address":{"type":"string","examples":["1 Example Street\nMelbourne\nVictoria\nAustralia\n3000"]},"address_oneline":{"type":"string","examples":["1 Example Street, Melbourne, Victoria, Australia, 3000"]},"address.country":{"type":"string","examples":["Australia"]},"address.country:raw":{"type":"string","examples":["AUS"]},"address.city":{"type":"string","examples":["Melbourne"]},"address.region":{"type":"string","examples":["Victoria"]},"address.region:raw":{"type":"string","examples":["VIC"]},"address.postcode":{"type":"string","examples":["3000"]},"address.street_address_1":{"type":"string","examples":["1 Example Street"]},"address.street_address_2":{"type":["string","null"],"examples":[null]},"address.street_address_3":{"type":["string","null"],"examples":[null]},"address.latitude":{"type":"string","examples":["-37.814000"]},"address.longitude":{"type":"string","examples":["144.963200"]},"family_id":{"type":["string","null"],"examples":[null]},"has_family_members":{"type":"string","examples":["No"]},"manages_family":{"type":"boolean","examples":[false]},"family_manager":{"type":"string","examples":["No"]},"family_member":{"type":"string","examples":["No"]},"is_family_member":{"type":"boolean","examples":[false]},"is_engaged":{"type":"string","examples":["No"]},"is_engaged:raw":{"type":"boolean","examples":[false]},"last_engaged_at":{"type":["string","null"],"examples":[null]},"last_engaged_at:raw":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["May 29, 2026, 6:30 PM"]},"created_at__date":{"type":"string","examples":["May 29, 2026"]},"created_at__time":{"type":"string","examples":["6:30 PM"]},"created_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"created_at__offset_minutes":{"type":"integer","examples":[0]},"created_at__dayofweek":{"type":"string","examples":["Friday"]},"email_verified":{"type":"string","examples":["No"]},"from_source":{"type":"string","examples":[""]},"interests":{"type":["string","null"],"examples":[null]},"interests:value":{"type":["string","null"],"examples":[null]},"interests:array":{"type":["string","null"],"examples":[null]},"is_subscribed_transactional":{"type":"string","examples":["Yes"]},"is_team_leader":{"type":"string","examples":["No"]},"middle_name":{"type":"string","examples":[""]},"picture_status":{"type":"string","examples":["N/A"]},"picture_status:value":{"type":"integer","examples":[0]},"picture_status:array":{"type":"string","examples":["N/A"]},"shift_privacy":{"type":"string","examples":["Yes"]},"updated_at":{"type":"string","examples":["Jun 9, 2026, 5:35 AM"]},"updated_at__date":{"type":"string","examples":["Jun 9, 2026"]},"updated_at__time":{"type":"string","examples":["5:35 AM"]},"updated_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"updated_at__offset_minutes":{"type":"integer","examples":[0]},"updated_at__dayofweek":{"type":"string","examples":["Tuesday"]},"first_name":{"type":"string","examples":["Alex"]},"last_name":{"type":"string","examples":["Taylor"]},"preferred_name":{"type":"string","examples":[""]},"phone:qr_code_value":{"type":"string","examples":["au-390000000"]},"phone":{"type":"string","examples":["(+61) 390000000"]},"phone:raw":{"type":"string","examples":["+61390000000"]},"phone:local_au":{"type":"string","examples":["0390000000"]},"dob":{"type":"string","examples":["Apr 12, 1990"]},"dob__dayofweek":{"type":"string","examples":["Thursday"]},"is_subscribed":{"type":"string","examples":["No"]},"terms":{"type":"string","examples":["Yes"]},"name":{"type":"string","examples":["Alex Taylor"]},"age":{"type":"integer","examples":[36]},"age_months":{"type":"string","examples":["36 years, 4 months"]},"info":{"type":"string","examples":["Alex Taylor (alex.taylor@example.com)"]},"preferred_first_name":{"type":"string","examples":["Alex"]},"delete_requested":{"type":"boolean","examples":[false]},"updated_hours":{"type":"number","examples":[1673.4862143775]},"is_community_user":{"type":"boolean","examples":[false]},"timezone":{"type":"string","examples":["UTC"]}}},"relations":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}},"attributes":{"type":"array","examples":[[]]},"id":{"type":"integer","examples":[23453479]},"name":{"type":"string","examples":["Alex Taylor"]}}},"examples":[[{"object":{"id":23453479,"id_token":"xxxxxxxxxxxxxxxxxxxxxxxx","account_id":20101,"email":"alex.taylor@example.com","force_reset_password":0,"password_expires_at":null,"first_name":"Alex","middle_name":null,"last_name":"Taylor","preferred_name":null,"phone":"au-390000000","dob":"1990-04-12","picture":null,"picture_status":0,"is_subscribed":0,"is_subscribed_transactional":1,"is_unreachable":0,"is_unreachable_sms":0,"terms":1,"rating":"0.00","shift_privacy":1,"is_team_leader":0,"email_verified":0,"login_lockout_attempts":0,"login_lockout_at":null,"login_lockout_email_sent_at":null,"last_login_at":null,"last_app_login_at":null,"is_archived":0,"last_activated":null,"from_source":null,"delete_requested_at":null,"deleted_at":null,"is_erased":0,"created_at":"2026-05-29T18:30:58.000000Z","updated_at":"2026-06-09T05:35:38.000000Z","deleted_by":null,"interests":null,"address":{"iso":"AUS","region_code":"VIC","coordinates":{"latitude":"-37.814000","longitude":"144.963200"},"street_address_1":"1 Example Street","street_address_2":null,"street_address_3":null,"city":"Melbourne","postcode":"3000","region":"VIC","country":"AU","latitude":"-37.814000","longitude":"144.963200"}},"nice":{"rrn":"rrn:local:20101:user:xxxxxxxxxxxxxxxxxxxxxxxx","address":"1 Example Street\nMelbourne\nVictoria\nAustralia\n3000","address_oneline":"1 Example Street, Melbourne, Victoria, Australia, 3000","address.country":"Australia","address.country:raw":"AUS","address.city":"Melbourne","address.region":"Victoria","address.region:raw":"VIC","address.postcode":"3000","address.street_address_1":"1 Example Street","address.street_address_2":null,"address.street_address_3":null,"address.latitude":"-37.814000","address.longitude":"144.963200","family_id":null,"has_family_members":"No","manages_family":false,"family_manager":"No","family_member":"No","is_family_member":false,"is_engaged":"No","is_engaged:raw":false,"last_engaged_at":null,"last_engaged_at:raw":null,"created_at":"May 29, 2026, 6:30 PM","created_at__date":"May 29, 2026","created_at__time":"6:30 PM","created_at__offset":" (+00:00 UTC)","created_at__offset_minutes":0,"created_at__dayofweek":"Friday","email_verified":"No","from_source":"","interests":null,"interests:value":null,"interests:array":null,"is_subscribed_transactional":"Yes","is_team_leader":"No","middle_name":"","picture_status":"N/A","picture_status:value":0,"picture_status:array":"N/A","shift_privacy":"Yes","updated_at":"Jun 9, 2026, 5:35 AM","updated_at__date":"Jun 9, 2026","updated_at__time":"5:35 AM","updated_at__offset":" (+00:00 UTC)","updated_at__offset_minutes":0,"updated_at__dayofweek":"Tuesday","first_name":"Alex","last_name":"Taylor","preferred_name":"","phone:qr_code_value":"au-390000000","phone":"(+61) 390000000","phone:raw":"+61390000000","phone:local_au":"0390000000","dob":"Apr 12, 1990","dob__dayofweek":"Thursday","is_subscribed":"No","terms":"Yes","name":"Alex Taylor","age":36,"age_months":"36 years, 4 months","info":"Alex Taylor (alex.taylor@example.com)","preferred_first_name":"Alex","delete_requested":false,"updated_hours":1673.4862143775,"is_community_user":false,"timezone":"UTC"},"relations":[],"permissions":{"read":true,"update":true,"delete":true},"attributes":[],"id":23453479,"name":"Alex Taylor"},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}]]},"first_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/user?per_page=5&_locale=en-US&page=1"]},"from":{"type":"integer","examples":[1]},"next_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/user?per_page=5&_locale=en-US&page=2"]},"path":{"type":"string","examples":["https://example.rosterfy.com/api/v2/user"]},"per_page":{"type":"integer","examples":[5]},"prev_page_url":{"type":["string","null"],"examples":[null]},"to":{"type":"integer","examples":[5]}}},"examples":[[{"current_page":1,"data":[{"object":{"id":23453479,"id_token":"xxxxxxxxxxxxxxxxxxxxxxxx","account_id":20101,"email":"alex.taylor@example.com","force_reset_password":0,"password_expires_at":null,"first_name":"Alex","middle_name":null,"last_name":"Taylor","preferred_name":null,"phone":"au-390000000","dob":"1990-04-12","picture":null,"picture_status":0,"is_subscribed":0,"is_subscribed_transactional":1,"is_unreachable":0,"is_unreachable_sms":0,"terms":1,"rating":"0.00","shift_privacy":1,"is_team_leader":0,"email_verified":0,"login_lockout_attempts":0,"login_lockout_at":null,"login_lockout_email_sent_at":null,"last_login_at":null,"last_app_login_at":null,"is_archived":0,"last_activated":null,"from_source":null,"delete_requested_at":null,"deleted_at":null,"is_erased":0,"created_at":"2026-05-29T18:30:58.000000Z","updated_at":"2026-06-09T05:35:38.000000Z","deleted_by":null,"interests":null,"address":{"iso":"AUS","region_code":"VIC","coordinates":{"latitude":"-37.814000","longitude":"144.963200"},"street_address_1":"1 Example Street","street_address_2":null,"street_address_3":null,"city":"Melbourne","postcode":"3000","region":"VIC","country":"AU","latitude":"-37.814000","longitude":"144.963200"}},"nice":{"rrn":"rrn:local:20101:user:xxxxxxxxxxxxxxxxxxxxxxxx","address":"1 Example Street\nMelbourne\nVictoria\nAustralia\n3000","address_oneline":"1 Example Street, Melbourne, Victoria, Australia, 3000","address.country":"Australia","address.country:raw":"AUS","address.city":"Melbourne","address.region":"Victoria","address.region:raw":"VIC","address.postcode":"3000","address.street_address_1":"1 Example Street","address.street_address_2":null,"address.street_address_3":null,"address.latitude":"-37.814000","address.longitude":"144.963200","family_id":null,"has_family_members":"No","manages_family":false,"family_manager":"No","family_member":"No","is_family_member":false,"is_engaged":"No","is_engaged:raw":false,"last_engaged_at":null,"last_engaged_at:raw":null,"created_at":"May 29, 2026, 6:30 PM","created_at__date":"May 29, 2026","created_at__time":"6:30 PM","created_at__offset":" (+00:00 UTC)","created_at__offset_minutes":0,"created_at__dayofweek":"Friday","email_verified":"No","from_source":"","interests":null,"interests:value":null,"interests:array":null,"is_subscribed_transactional":"Yes","is_team_leader":"No","middle_name":"","picture_status":"N/A","picture_status:value":0,"picture_status:array":"N/A","shift_privacy":"Yes","updated_at":"Jun 9, 2026, 5:35 AM","updated_at__date":"Jun 9, 2026","updated_at__time":"5:35 AM","updated_at__offset":" (+00:00 UTC)","updated_at__offset_minutes":0,"updated_at__dayofweek":"Tuesday","first_name":"Alex","last_name":"Taylor","preferred_name":"","phone:qr_code_value":"au-390000000","phone":"(+61) 390000000","phone:raw":"+61390000000","phone:local_au":"0390000000","dob":"Apr 12, 1990","dob__dayofweek":"Thursday","is_subscribed":"No","terms":"Yes","name":"Alex Taylor","age":36,"age_months":"36 years, 4 months","info":"Alex Taylor (alex.taylor@example.com)","preferred_first_name":"Alex","delete_requested":false,"updated_hours":1673.4862143775,"is_community_user":false,"timezone":"UTC"},"relations":[],"permissions":{"read":true,"update":true,"delete":true},"attributes":[],"id":23453479,"name":"Alex Taylor"},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}],"first_page_url":"https://example.rosterfy.com/api/v2/user?per_page=5&_locale=en-US&page=1","from":1,"next_page_url":"https://example.rosterfy.com/api/v2/user?per_page=5&_locale=en-US&page=2","path":"https://example.rosterfy.com/api/v2/user","per_page":5,"prev_page_url":null,"to":5}]]},"id":"schema_279"},"schema_280":{"kind":"json-schema","data":{"type":"object","properties":{"email":{"type":"string","description":"The email address of the User. Must be unique.","examples":["alex.taylor@example.com"]},"first_name":{"type":"string","description":"The first name of the User","examples":["Alex"]},"last_name":{"type":"string","description":"The last name of the User","examples":["Taylor"]},"dob":{"type":"string","description":"Date of birth in Y-m-d format","examples":["1990-04-12"]},"phone":{"type":"string","description":"Phone number","examples":["au-390000000"]},"terms":{"type":"boolean","description":"Whether the User has accepted the terms and conditions.","examples":[true]},"address":{"type":"object","description":"The address of the User.","properties":{},"examples":[{"street":"123 Example St","city":"Example City","state":"EX","postcode":"12345","country":"Example Country"}]},"picture":{"type":"string","description":"","examples":[null]},"account_role":{"type":"array","description":"An ID of an account role (Admin Permission) to place User into.","items":{"type":"string"},"examples":[[]]},"user_checkpoint_id":{"type":"integer","description":"The ID of the checkpoint the user should be placed into.","examples":[1]},"user_type_id":{"type":"integer","description":"Set the User Type of the User.","examples":[1]},"invitation_token":{"type":"string","description":"","examples":[null]},"custom_*":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A custom attribute, named by its code - custom_shirt_size, for example. The value follows the attribute's own type, so it may be a string, a number, a boolean or a list. See the custom attributes documentation."},"children":[]}]}]}],"examples":[null]}},"required":["email","first_name","last_name","dob","terms"]},"id":"schema_280"},"schema_281":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"email":{"type":"string","examples":["alex.taylor@example.com"]},"first_name":{"type":"string","examples":["Alex"]},"last_name":{"type":"string","examples":["Taylor"]},"dob":{"type":"string","examples":["1990-04-12"]},"phone":{"type":"string","examples":["au-390000000"]},"terms":{"type":"boolean","examples":[true]},"account_id":{"type":"integer","examples":[20101]},"is_unreachable":{"type":"integer","examples":[0]},"email_verified":{"type":"integer","examples":[0]},"is_unreachable_sms":{"type":"integer","examples":[0]},"id_token":{"type":"string","examples":["xxxxxxxxxxxxxxxxxxxxxxxx"]},"is_subscribed_transactional":{"type":"boolean","examples":[true]},"updated_at":{"type":"string","examples":["2026-08-17T23:04:48.000000Z"]},"created_at":{"type":"string","examples":["2026-08-17T23:04:48.000000Z"]},"id":{"type":"integer","examples":[23453703]},"interests":{"type":["string","null"],"examples":[null]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:user:xxxxxxxxxxxxxxxxxxxxxxxx"]},"address":{"type":"string","examples":["No Address"]},"address_oneline":{"type":"string","examples":["No Address"]},"family_id":{"type":["string","null"],"examples":[null]},"has_family_members":{"type":"string","examples":["No"]},"manages_family":{"type":"boolean","examples":[false]},"family_manager":{"type":"string","examples":["No"]},"family_member":{"type":"string","examples":["No"]},"is_family_member":{"type":"boolean","examples":[false]},"is_engaged":{"type":"string","examples":["No"]},"is_engaged:raw":{"type":"boolean","examples":[false]},"last_engaged_at":{"type":["string","null"],"examples":[null]},"last_engaged_at:raw":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["Aug 17, 2026, 11:04 PM"]},"created_at__date":{"type":"string","examples":["Aug 17, 2026"]},"created_at__time":{"type":"string","examples":["11:04 PM"]},"created_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"created_at__offset_minutes":{"type":"integer","examples":[0]},"created_at__dayofweek":{"type":"string","examples":["Monday"]},"email_verified":{"type":"string","examples":["No"]},"from_source":{"type":"string","examples":[""]},"interests":{"type":["string","null"],"examples":[null]},"interests:value":{"type":["string","null"],"examples":[null]},"interests:array":{"type":["string","null"],"examples":[null]},"is_subscribed_transactional":{"type":"string","examples":["Yes"]},"is_team_leader":{"type":"string","examples":["No"]},"middle_name":{"type":"string","examples":[""]},"picture_status":{"type":"string","examples":["N/A"]},"picture_status:value":{"type":["string","null"],"examples":[null]},"picture_status:array":{"type":["string","null"],"examples":[null]},"shift_privacy":{"type":"string","examples":["No"]},"updated_at":{"type":"string","examples":["Aug 17, 2026, 11:04 PM"]},"updated_at__date":{"type":"string","examples":["Aug 17, 2026"]},"updated_at__time":{"type":"string","examples":["11:04 PM"]},"updated_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"updated_at__offset_minutes":{"type":"integer","examples":[0]},"updated_at__dayofweek":{"type":"string","examples":["Monday"]},"first_name":{"type":"string","examples":["Alex"]},"last_name":{"type":"string","examples":["Taylor"]},"preferred_name":{"type":"string","examples":[""]},"phone:qr_code_value":{"type":"string","examples":["au-390000000"]},"phone":{"type":"string","examples":["(+61) 390000000"]},"phone:raw":{"type":"string","examples":["+61390000000"]},"phone:local_au":{"type":"string","examples":["0390000000"]},"dob":{"type":"string","examples":["Apr 12, 1990"]},"dob__dayofweek":{"type":"string","examples":["Thursday"]},"is_subscribed":{"type":"string","examples":["No"]},"terms":{"type":"string","examples":["Yes"]},"name":{"type":"string","examples":["Alex Taylor"]},"age":{"type":"integer","examples":[36]},"age_months":{"type":"string","examples":["36 years, 4 months"]},"info":{"type":"string","examples":["Alex Taylor (alex.taylor@example.com)"]},"preferred_first_name":{"type":"string","examples":["Alex"]},"delete_requested":{"type":"boolean","examples":[false]},"updated_hours":{"type":"number","examples":[0.00041929472222222]},"is_community_user":{"type":"boolean","examples":[false]},"timezone":{"type":"string","examples":["UTC"]}}},"relations":{"type":"object","properties":{"family_user":{"type":["string","null"],"examples":[null]},"user_type":{"type":["string","null"],"examples":[null]},"user_checkpoint":{"type":["string","null"],"examples":[null]},"family":{"type":["string","null"],"examples":[null]}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]},"impersonate":{"type":"boolean","examples":[true]}}},"attributes":{"type":"object","properties":{}},"id":{"type":"integer","examples":[23453703]},"name":{"type":"string","examples":["Alex Taylor"]}},"examples":[{"object":{"email":"alex.taylor@example.com","first_name":"Alex","last_name":"Taylor","dob":"1990-04-12","phone":"au-390000000","terms":true,"account_id":20101,"is_unreachable":0,"email_verified":0,"is_unreachable_sms":0,"id_token":"xxxxxxxxxxxxxxxxxxxxxxxx","is_subscribed_transactional":true,"updated_at":"2026-08-17T23:04:48.000000Z","created_at":"2026-08-17T23:04:48.000000Z","id":23453703,"interests":null},"nice":{"rrn":"rrn:local:20101:user:xxxxxxxxxxxxxxxxxxxxxxxx","address":"No Address","address_oneline":"No Address","family_id":null,"has_family_members":"No","manages_family":false,"family_manager":"No","family_member":"No","is_family_member":false,"is_engaged":"No","is_engaged:raw":false,"last_engaged_at":null,"last_engaged_at:raw":null,"created_at":"Aug 17, 2026, 11:04 PM","created_at__date":"Aug 17, 2026","created_at__time":"11:04 PM","created_at__offset":" (+00:00 UTC)","created_at__offset_minutes":0,"created_at__dayofweek":"Monday","email_verified":"No","from_source":"","interests":null,"interests:value":null,"interests:array":null,"is_subscribed_transactional":"Yes","is_team_leader":"No","middle_name":"","picture_status":"N/A","picture_status:value":null,"picture_status:array":null,"shift_privacy":"No","updated_at":"Aug 17, 2026, 11:04 PM","updated_at__date":"Aug 17, 2026","updated_at__time":"11:04 PM","updated_at__offset":" (+00:00 UTC)","updated_at__offset_minutes":0,"updated_at__dayofweek":"Monday","first_name":"Alex","last_name":"Taylor","preferred_name":"","phone:qr_code_value":"au-390000000","phone":"(+61) 390000000","phone:raw":"+61390000000","phone:local_au":"0390000000","dob":"Apr 12, 1990","dob__dayofweek":"Thursday","is_subscribed":"No","terms":"Yes","name":"Alex Taylor","age":36,"age_months":"36 years, 4 months","info":"Alex Taylor (alex.taylor@example.com)","preferred_first_name":"Alex","delete_requested":false,"updated_hours":0.00041929472222222,"is_community_user":false,"timezone":"UTC"},"relations":{"family_user":null,"user_type":null,"user_checkpoint":null,"family":null},"permissions":{"read":true,"update":true,"delete":true,"impersonate":true},"attributes":{},"id":23453703,"name":"Alex Taylor"}]},"id":"schema_281"},"schema_282":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","examples":["Sorry, we found issues with some of the submitted data - please review and try again."]},"errors":{"type":"object","properties":{"first_name":{"type":"array","items":{"type":"string"},"examples":[["Field is required."]]},"last_name":{"type":"array","items":{"type":"string"},"examples":[["Field is required."]]}}}},"examples":[{"message":"Sorry, we found issues with some of the submitted data - please review and try again.","errors":{"first_name":["Field is required."],"last_name":["Field is required."]}}]},"id":"schema_282"},"schema_283":{"kind":"json-schema","data":{"type":"object","properties":{"filter":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The filter structure the listing accepts. Used when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"applyTo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"all"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"items":{"type":"object"},"examples":[[[]]]},"group_id":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Narrows an "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"applyTo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"all"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to the members of one group. Not validated."},"children":[]}]}]}],"examples":[16]},"applyTo":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether to update the ids in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or everyone the request matches. One of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"all"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"selected":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"IDs of the users to update. Required unless "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"applyTo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"all"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"items":{"type":"integer"},"examples":[[]]},"custom_*":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A custom attribute, named by its code - custom_shirt_size, for example. The value follows the attribute's own type, so it may be a string, a number, a boolean or a list. See the custom attributes documentation."},"children":[]}]}]}],"examples":[null]}}},"id":"schema_283"},"schema_284":{"kind":"json-schema","data":{"type":"object","properties":{"queue":{"type":"string","examples":["mTsVQ1NCLS3vg7WwP5kG1Vbt"]}},"examples":[{"queue":"mTsVQ1NCLS3vg7WwP5kG1Vbt"}]},"id":"schema_284"},"schema_285":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","examples":["Sorry, we found issues with some of the submitted data - please review and try again."]},"errors":{"type":"object","properties":{"selected":{"type":"array","items":{"type":"string"},"examples":[["Please select at least one User"]]}}}},"examples":[{"message":"Sorry, we found issues with some of the submitted data - please review and try again.","errors":{"selected":["Please select at least one User"]}}]},"id":"schema_285"},"schema_286":{"kind":"json-schema","data":{"type":"integer","examples":[23453479]},"id":"schema_286"},"schema_287":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[23453479]},"id_token":{"type":"string","examples":["xxxxxxxxxxxxxxxxxxxxxxxx"]},"account_id":{"type":"integer","examples":[20101]},"email":{"type":"string","examples":["alex.taylor@example.com"]},"force_reset_password":{"type":"integer","examples":[0]},"password_expires_at":{"type":["string","null"],"examples":[null]},"first_name":{"type":"string","examples":["Alex"]},"middle_name":{"type":["string","null"],"examples":[null]},"last_name":{"type":"string","examples":["Taylor"]},"preferred_name":{"type":["string","null"],"examples":[null]},"phone":{"type":"string","examples":["au-390000000"]},"dob":{"type":"string","examples":["1990-04-12"]},"picture":{"type":["string","null"],"examples":[null]},"picture_status":{"type":"integer","examples":[0]},"is_subscribed":{"type":"integer","examples":[0]},"is_subscribed_transactional":{"type":"integer","examples":[1]},"is_unreachable":{"type":"integer","examples":[0]},"is_unreachable_sms":{"type":"integer","examples":[0]},"terms":{"type":"integer","examples":[1]},"rating":{"type":"string","examples":["0.00"]},"shift_privacy":{"type":"integer","examples":[1]},"is_team_leader":{"type":"integer","examples":[0]},"email_verified":{"type":"integer","examples":[0]},"login_lockout_attempts":{"type":"integer","examples":[0]},"login_lockout_at":{"type":["string","null"],"examples":[null]},"login_lockout_email_sent_at":{"type":["string","null"],"examples":[null]},"last_login_at":{"type":["string","null"],"examples":[null]},"last_app_login_at":{"type":["string","null"],"examples":[null]},"is_archived":{"type":"integer","examples":[0]},"last_activated":{"type":["string","null"],"examples":[null]},"from_source":{"type":["string","null"],"examples":[null]},"delete_requested_at":{"type":["string","null"],"examples":[null]},"deleted_at":{"type":["string","null"],"examples":[null]},"is_erased":{"type":"integer","examples":[0]},"created_at":{"type":"string","examples":["2026-05-29T18:30:58.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:35:38.000000Z"]},"deleted_by":{"type":["string","null"],"examples":[null]},"interests":{"type":["string","null"],"examples":[null]},"address":{"type":"object","properties":{"iso":{"type":"string","examples":["AUS"]},"region_code":{"type":"string","examples":["VIC"]},"coordinates":{"type":"object","properties":{"latitude":{"type":"string","examples":["-37.814000"]},"longitude":{"type":"string","examples":["144.963200"]}}},"street_address_1":{"type":"string","examples":["1 Example Street"]},"street_address_2":{"type":["string","null"],"examples":[null]},"street_address_3":{"type":["string","null"],"examples":[null]},"city":{"type":"string","examples":["Melbourne"]},"postcode":{"type":"string","examples":["3000"]},"region":{"type":"string","examples":["VIC"]},"country":{"type":"string","examples":["AU"]},"latitude":{"type":"string","examples":["-37.814000"]},"longitude":{"type":"string","examples":["144.963200"]}}}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:user:xxxxxxxxxxxxxxxxxxxxxxxx"]},"address":{"type":"string","examples":["1 Example Street\nMelbourne\nVictoria\nAustralia\n3000"]},"address_oneline":{"type":"string","examples":["1 Example Street, Melbourne, Victoria, Australia, 3000"]},"address.country":{"type":"string","examples":["Australia"]},"address.country:raw":{"type":"string","examples":["AUS"]},"address.city":{"type":"string","examples":["Melbourne"]},"address.region":{"type":"string","examples":["Victoria"]},"address.region:raw":{"type":"string","examples":["VIC"]},"address.postcode":{"type":"string","examples":["3000"]},"address.street_address_1":{"type":"string","examples":["1 Example Street"]},"address.street_address_2":{"type":["string","null"],"examples":[null]},"address.street_address_3":{"type":["string","null"],"examples":[null]},"address.latitude":{"type":"string","examples":["-37.814000"]},"address.longitude":{"type":"string","examples":["144.963200"]},"family_id":{"type":["string","null"],"examples":[null]},"has_family_members":{"type":"string","examples":["No"]},"manages_family":{"type":"boolean","examples":[false]},"family_manager":{"type":"string","examples":["No"]},"family_member":{"type":"string","examples":["No"]},"is_family_member":{"type":"boolean","examples":[false]},"is_engaged":{"type":"string","examples":["No"]},"is_engaged:raw":{"type":"boolean","examples":[false]},"last_engaged_at":{"type":["string","null"],"examples":[null]},"last_engaged_at:raw":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["May 29, 2026, 6:30 PM"]},"created_at__date":{"type":"string","examples":["May 29, 2026"]},"created_at__time":{"type":"string","examples":["6:30 PM"]},"created_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"created_at__offset_minutes":{"type":"integer","examples":[0]},"created_at__dayofweek":{"type":"string","examples":["Friday"]},"email_verified":{"type":"string","examples":["No"]},"from_source":{"type":"string","examples":[""]},"interests":{"type":["string","null"],"examples":[null]},"interests:value":{"type":["string","null"],"examples":[null]},"interests:array":{"type":["string","null"],"examples":[null]},"is_subscribed_transactional":{"type":"string","examples":["Yes"]},"is_team_leader":{"type":"string","examples":["No"]},"middle_name":{"type":"string","examples":[""]},"picture_status":{"type":"string","examples":["N/A"]},"picture_status:value":{"type":"integer","examples":[0]},"picture_status:array":{"type":"string","examples":["N/A"]},"shift_privacy":{"type":"string","examples":["Yes"]},"updated_at":{"type":"string","examples":["Jun 9, 2026, 5:35 AM"]},"updated_at__date":{"type":"string","examples":["Jun 9, 2026"]},"updated_at__time":{"type":"string","examples":["5:35 AM"]},"updated_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"updated_at__offset_minutes":{"type":"integer","examples":[0]},"updated_at__dayofweek":{"type":"string","examples":["Tuesday"]},"first_name":{"type":"string","examples":["Alex"]},"last_name":{"type":"string","examples":["Taylor"]},"preferred_name":{"type":"string","examples":[""]},"phone:qr_code_value":{"type":"string","examples":["au-390000000"]},"phone":{"type":"string","examples":["(+61) 390000000"]},"phone:raw":{"type":"string","examples":["+61390000000"]},"phone:local_au":{"type":"string","examples":["0390000000"]},"dob":{"type":"string","examples":["Apr 12, 1990"]},"dob__dayofweek":{"type":"string","examples":["Thursday"]},"is_subscribed":{"type":"string","examples":["No"]},"terms":{"type":"string","examples":["Yes"]},"name":{"type":"string","examples":["Alex Taylor"]},"age":{"type":"integer","examples":[36]},"age_months":{"type":"string","examples":["36 years, 4 months"]},"info":{"type":"string","examples":["Alex Taylor (alex.taylor@example.com)"]},"preferred_first_name":{"type":"string","examples":["Alex"]},"delete_requested":{"type":"boolean","examples":[false]},"updated_hours":{"type":"number","examples":[1673.4862143775]},"is_community_user":{"type":"boolean","examples":[false]},"timezone":{"type":"string","examples":["UTC"]}}},"relations":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}},"attributes":{"type":"object","properties":{}},"id":{"type":"integer","examples":[23453479]},"name":{"type":"string","examples":["Alex Taylor"]}},"examples":[{"object":{"id":23453479,"id_token":"xxxxxxxxxxxxxxxxxxxxxxxx","account_id":20101,"email":"alex.taylor@example.com","force_reset_password":0,"password_expires_at":null,"first_name":"Alex","middle_name":null,"last_name":"Taylor","preferred_name":null,"phone":"au-390000000","dob":"1990-04-12","picture":null,"picture_status":0,"is_subscribed":0,"is_subscribed_transactional":1,"is_unreachable":0,"is_unreachable_sms":0,"terms":1,"rating":"0.00","shift_privacy":1,"is_team_leader":0,"email_verified":0,"login_lockout_attempts":0,"login_lockout_at":null,"login_lockout_email_sent_at":null,"last_login_at":null,"last_app_login_at":null,"is_archived":0,"last_activated":null,"from_source":null,"delete_requested_at":null,"deleted_at":null,"is_erased":0,"created_at":"2026-05-29T18:30:58.000000Z","updated_at":"2026-06-09T05:35:38.000000Z","deleted_by":null,"interests":null,"address":{"iso":"AUS","region_code":"VIC","coordinates":{"latitude":"-37.814000","longitude":"144.963200"},"street_address_1":"1 Example Street","street_address_2":null,"street_address_3":null,"city":"Melbourne","postcode":"3000","region":"VIC","country":"AU","latitude":"-37.814000","longitude":"144.963200"}},"nice":{"rrn":"rrn:local:20101:user:xxxxxxxxxxxxxxxxxxxxxxxx","address":"1 Example Street\nMelbourne\nVictoria\nAustralia\n3000","address_oneline":"1 Example Street, Melbourne, Victoria, Australia, 3000","address.country":"Australia","address.country:raw":"AUS","address.city":"Melbourne","address.region":"Victoria","address.region:raw":"VIC","address.postcode":"3000","address.street_address_1":"1 Example Street","address.street_address_2":null,"address.street_address_3":null,"address.latitude":"-37.814000","address.longitude":"144.963200","family_id":null,"has_family_members":"No","manages_family":false,"family_manager":"No","family_member":"No","is_family_member":false,"is_engaged":"No","is_engaged:raw":false,"last_engaged_at":null,"last_engaged_at:raw":null,"created_at":"May 29, 2026, 6:30 PM","created_at__date":"May 29, 2026","created_at__time":"6:30 PM","created_at__offset":" (+00:00 UTC)","created_at__offset_minutes":0,"created_at__dayofweek":"Friday","email_verified":"No","from_source":"","interests":null,"interests:value":null,"interests:array":null,"is_subscribed_transactional":"Yes","is_team_leader":"No","middle_name":"","picture_status":"N/A","picture_status:value":0,"picture_status:array":"N/A","shift_privacy":"Yes","updated_at":"Jun 9, 2026, 5:35 AM","updated_at__date":"Jun 9, 2026","updated_at__time":"5:35 AM","updated_at__offset":" (+00:00 UTC)","updated_at__offset_minutes":0,"updated_at__dayofweek":"Tuesday","first_name":"Alex","last_name":"Taylor","preferred_name":"","phone:qr_code_value":"au-390000000","phone":"(+61) 390000000","phone:raw":"+61390000000","phone:local_au":"0390000000","dob":"Apr 12, 1990","dob__dayofweek":"Thursday","is_subscribed":"No","terms":"Yes","name":"Alex Taylor","age":36,"age_months":"36 years, 4 months","info":"Alex Taylor (alex.taylor@example.com)","preferred_first_name":"Alex","delete_requested":false,"updated_hours":1673.4862143775,"is_community_user":false,"timezone":"UTC"},"relations":[],"permissions":{"read":true,"update":true,"delete":true},"attributes":{},"id":23453479,"name":"Alex Taylor"}]},"id":"schema_287"},"schema_288":{"kind":"json-schema","data":{"type":"object","properties":{"email":{"type":"string","description":"The email address of the User. Must be unique.","examples":["alex.taylor@example.com"]},"preferred_name":{"type":"string","description":"","examples":[null]},"first_name":{"type":"string","description":"The first name of the User","examples":["Alex"]},"middle_name":{"type":"string","description":"","examples":[null]},"last_name":{"type":"string","description":"The last name of the User","examples":["Taylor"]},"phone":{"type":"string","description":"Phone number","examples":["au-390000000"]},"dob":{"type":"string","description":"Date of birth in Y-m-d format","examples":["1990-04-12"]},"address":{"type":"object","description":"The address of the User.","properties":{},"examples":[{"iso":"AUS","region_code":"VIC","coordinates":{"latitude":"-37.814000","longitude":"144.963200"},"street_address_1":"1 Example Street","street_address_2":null,"street_address_3":null,"city":"Melbourne","postcode":"3000","region":"VIC","country":"AU","latitude":"-37.814000","longitude":"144.963200"}]},"is_subscribed":{"type":"boolean","description":"","examples":[0]},"picture":{"type":"string","description":"","examples":[null]},"account_role":{"type":"string","description":"An ID of an account role (Admin Permission) to place User into.","examples":[null]},"user_checkpoint_id":{"type":"integer","description":"The ID of the checkpoint the user should be placed into.","examples":[1]},"user_type_id":{"type":"integer","description":"Set the User Type of the User.","examples":[1]},"is_archived":{"type":"boolean","description":"Whether the User is archived.","examples":[0]},"general:timezone":{"type":"string","description":"","examples":[null]},"custom_*":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A custom attribute, named by its code - custom_shirt_size, for example. The value follows the attribute's own type, so it may be a string, a number, a boolean or a list. See the custom attributes documentation."},"children":[]}]}]}],"examples":[null]}}},"id":"schema_288"},"schema_289":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","examples":["Sorry, we found issues with some of the submitted data - please review and try again."]},"errors":{"type":"object","properties":{"email":{"type":"array","items":{"type":"string"},"examples":[["Must be a valid email address."]]}}}},"examples":[{"message":"Sorry, we found issues with some of the submitted data - please review and try again.","errors":{"email":["Must be a valid email address."]}}]},"id":"schema_289"},"schema_290":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","examples":["Reports and groups created by this user rely on their permissions. If you remove all their roles, these reports and groups will be updated to use your permissions"]},"reference":{"type":"string","examples":["account.role.delete"]}},"examples":[{"message":"Reports and groups created by this user rely on their permissions. If you remove all their roles, these reports and groups will be updated to use your permissions","reference":"account.role.delete"}]},"id":"schema_290"},"schema_291":{"kind":"json-schema","data":{"type":"object","properties":{"applyTo":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Which records to act on: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"all"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":["selected"]},"selected":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"IDs of the records named by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"entity"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Needed when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"applyTo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"items":{"type":"integer"},"examples":[[16]]},"identifiers":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Narrows the chosen "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"entity"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to one parent record. See the description."},"children":[]}]}]}],"properties":{"event_id":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Required when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"entity"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"event_user"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; optional for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"event_shift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[16]},"shift_id":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"entity"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"event_shift_user"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[16]},"role_offer_id":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Required when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"entity"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"role_offer_user"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[16]}},"examples":[[]]},"filter":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The filter structure the matching listing accepts. Used when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"applyTo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"all"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"items":{"type":"object"},"examples":[[[]]]},"group_id":{"type":"array","description":"IDs of the groups to add the users to. Every group named here receives every user the request selects.","items":{"type":"integer"},"examples":[[]]},"entity":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"What the ids in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" refer to. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for user ids; the other values take the users attached to the named records instead - "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"event_shift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for shifts, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"event_shift_user"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for shift assignments, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"event_user"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for event registrations, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"role_offer_user"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for role offer applications."},"children":[]}]}]}],"examples":[null]}},"required":["applyTo","group_id","entity"]},"id":"schema_291"},"schema_292":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","examples":["Sorry, we found issues with some of the submitted data - please review and try again."]},"errors":{"type":"object","properties":{"group_id":{"type":"array","items":{"type":"string"},"examples":[["Field is required."]]}}}},"examples":[{"message":"Sorry, we found issues with some of the submitted data - please review and try again.","errors":{"group_id":["Field is required."]}}]},"id":"schema_292"},"schema_293":{"kind":"json-schema","data":{"type":"boolean","description":"Return the whole subtree rather than only the\naccounts one level down. Available when the account allows it.","examples":[true]},"id":"schema_293"},"schema_294":{"kind":"json-schema","data":{"type":"boolean","description":"Narrow the results to the sub-accounts\noffered in the account-switching menu. Available when the account allows it.","examples":[true]},"id":"schema_294"},"schema_295":{"kind":"json-schema","data":{"type":"array","description":"A list of extras to include in the response. These are objects or arrays that are not part of\nthe model's primary attributes, such as stats and counts.\nFor fast responses, avoid requesting them if you don't need them. ","items":{"type":"string","enum":["stats","domains","limits","certificate"]},"examples":[["stats"]]},"id":"schema_295"},"schema_296":{"kind":"json-schema","data":{"type":"array","description":"A list of relations to include in the response. May be single records or collections.\nIt is often more efficient to retrieve this way, to avoid follow-up API calls.","items":{"type":"string","enum":["users","brandings","account_terms_and_conditions_acceptance"]},"examples":[["users"]]},"id":"schema_296"},"schema_297":{"kind":"json-schema","data":{"type":"array","items":{"type":"object","properties":{"current_page":{"type":"integer","examples":[1]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[20101]},"parent_id":{"type":"integer","examples":[1]},"account_type_id":{"type":"integer","examples":[3]},"path":{"type":"string","examples":["1/20101"]},"name":{"type":"string","examples":["Example Organisation"]},"config":{"type":"object","properties":{"active_settings":{"type":"array","items":{"type":"string"},"examples":[["general:locale","general:timezone","general:country","users:login","users:register","users:require_dob","event:shift_status_default","event:self_checkin","branding:name","branding:primary_color"]]}}},"meta":{"type":"array","examples":[[]]},"visibility_rules":{"type":"array","examples":[[]]},"status":{"type":"string","examples":["approved"]},"status_reason":{"type":["string","null"],"examples":[null]},"sort_order":{"type":"integer","examples":[0]},"start_timestamp":{"type":["string","null"],"examples":[null]},"end_timestamp":{"type":["string","null"],"examples":[null]},"notes":{"type":["string","null"],"examples":[null]},"contact_firstname":{"type":["string","null"],"examples":[null]},"contact_lastname":{"type":["string","null"],"examples":[null]},"contact_email":{"type":["string","null"],"examples":[null]},"contact_phone":{"type":["string","null"],"examples":[null]},"support_manager_email":{"type":"string","examples":["support.manager@example.com"]},"allow_deletion_request":{"type":"integer","examples":[1]},"organization_type":{"type":["string","null"],"examples":[null]},"contract_start_date":{"type":"string","examples":["2026-06-09"]},"contract_end_date":{"type":"string","examples":["2027-06-09"]},"billing_contact_email":{"type":"string","examples":["billing@example.com"]},"billing_support_email":{"type":"string","examples":["billing.support@example.com"]},"is_enabled":{"type":"integer","examples":[1]},"additional_billing_support_email":{"type":"string","examples":["billing.additional@example.com"]},"delete_requested_at":{"type":["string","null"],"examples":[null]},"is_archived":{"type":"integer","examples":[0]},"trial_ends_at":{"type":["string","null"],"examples":[null]},"can_erase":{"type":"integer","examples":[0]},"deleted_at":{"type":["string","null"],"examples":[null]},"is_erased":{"type":"integer","examples":[0]},"created_at":{"type":"string","examples":["2026-06-09T05:33:32.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T07:08:01.000000Z"]},"domain":{"type":"array","items":{"type":"string"},"examples":[["example.rosterfy.com"]]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:1:account:20101"]},"address":{"type":"string","examples":["No Address"]},"address_oneline":{"type":"string","examples":["No Address"]},"account_type_id":{"type":"integer","examples":[3]},"account_type_id:value":{"type":"integer","examples":[3]},"account_type_id:array":{"type":"integer","examples":[3]},"allow_deletion_request":{"type":"string","examples":["Yes"]},"contact_firstname":{"type":"string","examples":[""]},"contact_lastname":{"type":"string","examples":[""]},"contact_phone:qr_code_value":{"type":"string","examples":[""]},"contact_phone":{"type":"string","examples":[""]},"contact_phone:raw":{"type":"string","examples":[""]},"contract_end_date":{"type":"string","examples":["Jun 9, 2027"]},"contract_end_date__dayofweek":{"type":"string","examples":["Wednesday"]},"contract_start_date":{"type":"string","examples":["Jun 9, 2026"]},"contract_start_date__dayofweek":{"type":"string","examples":["Tuesday"]},"name":{"type":"string","examples":["Example Organisation"]},"notes":{"type":"string","examples":[""]},"organization_type":{"type":["string","null"],"examples":[null]},"organization_type:value":{"type":["string","null"],"examples":[null]},"organization_type:array":{"type":["string","null"],"examples":[null]},"status":{"type":"string","examples":["Approved"]},"status:value":{"type":"string","examples":["approved"]},"status:array":{"type":"string","examples":["approved"]},"status_reason":{"type":"string","examples":[""]},"created_at":{"type":"string","examples":["2026-06-09 05:33:32"]},"url":{"type":"string","examples":["https://example.rosterfy.com/"]},"branding_name":{"type":"string","examples":["Example Organisation"]},"branding_subtitle":{"type":["string","null"],"examples":[null]},"branding_logo":{"type":["string","null"],"examples":[null]},"branding_logo_mono":{"type":["string","null"],"examples":[null]},"branding_logo_stacked":{"type":["string","null"],"examples":[null]},"branding_banner":{"type":["string","null"],"examples":[null]},"branding_favicon":{"type":["string","null"],"examples":[null]},"branding_description":{"type":["string","null"],"examples":[null]},"branding_primary_color":{"type":"string","examples":["#3131c7"]},"branding_complimentary_color":{"type":["string","null"],"examples":[null]},"branding_secondary_color":{"type":"string","examples":["#38b6ff"]},"register":{"type":"boolean","examples":[false]},"organisation_contact":{"type":"string","examples":[" "]},"has_subaccount_approved_email_template":{"type":"boolean","examples":[false]},"has_subaccount_rejected_email_template":{"type":"boolean","examples":[false]},"parent_account_name":{"type":"string","examples":["Example Parent Organisation"]}}},"relations":{"type":"object","properties":{"current_user_checkpoint":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[3]},"user_checkpoint_type_id":{"type":["string","null"],"examples":[null]},"name":{"type":"string","examples":["Default"]},"label":{"type":"string","examples":["default"]},"permissions":{"type":"object","properties":{"all":{"type":"string","examples":["1"]}}},"actions":{"type":"array","examples":[[]]},"is_inheritable":{"type":"integer","examples":[0]},"sort_order":{"type":"integer","examples":[0]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-06-09T05:33:39.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:34:24.000000Z"]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:checkpoint:3"]},"content_id":{"type":"integer","examples":[3]},"account_name_path":{"type":"string","examples":["Example Organisation"]},"is_foreign_account":{"type":"boolean","examples":[false]}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[false]}}}}},"parent":{"type":"array","examples":[[]]},"account":{"type":"array","examples":[[]]}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[false]},"delete":{"type":"boolean","examples":[false]},"apply":{"type":"boolean","examples":[false]},"apply_error":{"type":"string","examples":["Subaccount does not allow User to join"]},"view_subaccount_selection_menu":{"type":"boolean","examples":[false]}}},"attributes":{"type":"array","examples":[[]]}}},"examples":[[{"object":{"id":20101,"parent_id":1,"account_type_id":3,"path":"1/20101","name":"Example Organisation","config":{"active_settings":["general:locale","general:timezone","general:country","users:login","users:register","users:require_dob","event:shift_status_default","event:self_checkin","branding:name","branding:primary_color"]},"meta":[],"visibility_rules":[],"status":"approved","status_reason":null,"sort_order":0,"start_timestamp":null,"end_timestamp":null,"notes":null,"contact_firstname":null,"contact_lastname":null,"contact_email":null,"contact_phone":null,"support_manager_email":"support.manager@example.com","allow_deletion_request":1,"organization_type":null,"contract_start_date":"2026-06-09","contract_end_date":"2027-06-09","billing_contact_email":"billing@example.com","billing_support_email":"billing.support@example.com","is_enabled":1,"additional_billing_support_email":"billing.additional@example.com","delete_requested_at":null,"is_archived":0,"trial_ends_at":null,"can_erase":0,"deleted_at":null,"is_erased":0,"created_at":"2026-06-09T05:33:32.000000Z","updated_at":"2026-06-09T07:08:01.000000Z","domain":["example.rosterfy.com"]},"nice":{"rrn":"rrn:local:1:account:20101","address":"No Address","address_oneline":"No Address","account_type_id":3,"account_type_id:value":3,"account_type_id:array":3,"allow_deletion_request":"Yes","contact_firstname":"","contact_lastname":"","contact_phone:qr_code_value":"","contact_phone":"","contact_phone:raw":"","contract_end_date":"Jun 9, 2027","contract_end_date__dayofweek":"Wednesday","contract_start_date":"Jun 9, 2026","contract_start_date__dayofweek":"Tuesday","name":"Example Organisation","notes":"","organization_type":null,"organization_type:value":null,"organization_type:array":null,"status":"Approved","status:value":"approved","status:array":"approved","status_reason":"","created_at":"2026-06-09 05:33:32","url":"https://example.rosterfy.com/","branding_name":"Example Organisation","branding_subtitle":null,"branding_logo":null,"branding_logo_mono":null,"branding_logo_stacked":null,"branding_banner":null,"branding_favicon":null,"branding_description":null,"branding_primary_color":"#3131c7","branding_complimentary_color":null,"branding_secondary_color":"#38b6ff","register":false,"organisation_contact":" ","has_subaccount_approved_email_template":false,"has_subaccount_rejected_email_template":false,"parent_account_name":"Example Parent Organisation"},"relations":{"current_user_checkpoint":{"object":{"id":3,"user_checkpoint_type_id":null,"name":"Default","label":"default","permissions":{"all":"1"},"actions":[],"is_inheritable":0,"sort_order":0,"deleted_at":null,"created_at":"2026-06-09T05:33:39.000000Z","updated_at":"2026-06-09T05:34:24.000000Z"},"nice":{"rrn":"rrn:local:20101:checkpoint:3","content_id":3,"account_name_path":"Example Organisation","is_foreign_account":false},"permissions":{"read":true,"update":true,"delete":false}},"parent":[],"account":[]},"permissions":{"read":true,"update":false,"delete":false,"apply":false,"apply_error":"Subaccount does not allow User to join","view_subaccount_selection_menu":false},"attributes":[]},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}]]},"first_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/account?per_page=5&_locale=en-US&page=1"]},"from":{"type":"integer","examples":[1]},"next_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/account?per_page=5&_locale=en-US&page=2"]},"path":{"type":"string","examples":["https://example.rosterfy.com/api/v2/account"]},"per_page":{"type":"integer","examples":[5]},"prev_page_url":{"type":["string","null"],"examples":[null]},"to":{"type":"integer","examples":[5]}}},"examples":[[{"current_page":1,"data":[{"object":{"id":20101,"parent_id":1,"account_type_id":3,"path":"1/20101","name":"Example Organisation","config":{"active_settings":["general:locale","general:timezone","general:country","users:login","users:register","users:require_dob","event:shift_status_default","event:self_checkin","branding:name","branding:primary_color"]},"meta":[],"visibility_rules":[],"status":"approved","status_reason":null,"sort_order":0,"start_timestamp":null,"end_timestamp":null,"notes":null,"contact_firstname":null,"contact_lastname":null,"contact_email":null,"contact_phone":null,"support_manager_email":"support.manager@example.com","allow_deletion_request":1,"organization_type":null,"contract_start_date":"2026-06-09","contract_end_date":"2027-06-09","billing_contact_email":"billing@example.com","billing_support_email":"billing.support@example.com","is_enabled":1,"additional_billing_support_email":"billing.additional@example.com","delete_requested_at":null,"is_archived":0,"trial_ends_at":null,"can_erase":0,"deleted_at":null,"is_erased":0,"created_at":"2026-06-09T05:33:32.000000Z","updated_at":"2026-06-09T07:08:01.000000Z","domain":["example.rosterfy.com"]},"nice":{"rrn":"rrn:local:1:account:20101","address":"No Address","address_oneline":"No Address","account_type_id":3,"account_type_id:value":3,"account_type_id:array":3,"allow_deletion_request":"Yes","contact_firstname":"","contact_lastname":"","contact_phone:qr_code_value":"","contact_phone":"","contact_phone:raw":"","contract_end_date":"Jun 9, 2027","contract_end_date__dayofweek":"Wednesday","contract_start_date":"Jun 9, 2026","contract_start_date__dayofweek":"Tuesday","name":"Example Organisation","notes":"","organization_type":null,"organization_type:value":null,"organization_type:array":null,"status":"Approved","status:value":"approved","status:array":"approved","status_reason":"","created_at":"2026-06-09 05:33:32","url":"https://example.rosterfy.com/","branding_name":"Example Organisation","branding_subtitle":null,"branding_logo":null,"branding_logo_mono":null,"branding_logo_stacked":null,"branding_banner":null,"branding_favicon":null,"branding_description":null,"branding_primary_color":"#3131c7","branding_complimentary_color":null,"branding_secondary_color":"#38b6ff","register":false,"organisation_contact":" ","has_subaccount_approved_email_template":false,"has_subaccount_rejected_email_template":false,"parent_account_name":"Example Parent Organisation"},"relations":{"current_user_checkpoint":{"object":{"id":3,"user_checkpoint_type_id":null,"name":"Default","label":"default","permissions":{"all":"1"},"actions":[],"is_inheritable":0,"sort_order":0,"deleted_at":null,"created_at":"2026-06-09T05:33:39.000000Z","updated_at":"2026-06-09T05:34:24.000000Z"},"nice":{"rrn":"rrn:local:20101:checkpoint:3","content_id":3,"account_name_path":"Example Organisation","is_foreign_account":false},"permissions":{"read":true,"update":true,"delete":false}},"parent":[],"account":[]},"permissions":{"read":true,"update":false,"delete":false,"apply":false,"apply_error":"Subaccount does not allow User to join","view_subaccount_selection_menu":false},"attributes":[]},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}],"first_page_url":"https://example.rosterfy.com/api/v2/account?per_page=5&_locale=en-US&page=1","from":1,"next_page_url":"https://example.rosterfy.com/api/v2/account?per_page=5&_locale=en-US&page=2","path":"https://example.rosterfy.com/api/v2/account","per_page":5,"prev_page_url":null,"to":5}]]},"id":"schema_297"},"schema_298":{"kind":"json-schema","data":{"type":"object","properties":{"name":{"type":"string","description":"Display name of the sub-account, up to 255 characters. This is what people see in the account switcher and in anything branded with the account name.","examples":["Example Organisation"]},"contact_firstname":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"First name of the person to set up as the sub-account's first administrator. Required when _options.create_admin is set, and otherwise recorded as the account contact."},"children":[]}]}]}],"examples":[null]},"contact_lastname":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Last name of that person. Required when _options.create_admin is set."},"children":[]}]}]}],"examples":[null]},"contact_email":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Email address of that person, which becomes the administrator's sign-in address. Required when _options.create_admin is set."},"children":[]}]}]}],"examples":[null]},"contact_phone":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Phone number of that person, in international format such as au-297809703. Required when _options.create_admin is set."},"children":[]}]}]}],"examples":[null]},"_options":{"type":"object","description":"","properties":{"create_admin":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether to create an administrator in the new sub-account from the contact_* fields. Without it the contact details are stored but no one can sign in to the account yet. Create only."},"children":[]}]}]}],"examples":[true]},"send_welcome":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether to email that new administrator an invitation with a link to set their password. Only has an effect alongside _options.create_admin, and only when the account has a welcome email template configured. Create only."},"children":[]}]}]}],"examples":[true]}},"examples":[{"create_admin":true}]},"meta":{"type":"object","description":"","properties":{"publish":{"type":"boolean","description":"Whether the sub-account is listed to people browsing the sub-accounts they could join. Unpublished accounts stay reachable by direct link.","examples":[true]},"hide_from_new_applicants":{"type":"boolean","description":"Whether to keep the sub-account out of the list someone sees while registering. It stays visible to people who already have an account.","examples":[true]},"promote":{"type":"boolean","description":"Whether to feature the sub-account ahead of the others. The number of promoted accounts an account may have at once is capped, and exceeding it is rejected.","examples":[true]},"join":{"type":"boolean","description":"Whether people may join this sub-account themselves rather than being added to it.","examples":[true]}},"examples":[{"publish":true}]},"visibility_rules":{"type":"array","description":"Optional conditions narrowing which people may see or join this sub-account. Structure is not part of the contract and is not validated - build the rules in the admin console and send back what a read returns. Send an empty array to clear them.","items":{"type":"object"},"examples":[[]]},"sort_order":{"type":"integer","description":"Position of the sub-account in lists that show a group of them together. Lower sorts first; accounts sharing a value fall back to name order.","examples":[0]},"start_timestamp":{"type":"string","description":"When the sub-account becomes active, as YYYY-MM-DD HH:MM:SS. Must be within 25 years either side of now. Leave null for an account that is active immediately.","examples":[null]},"end_timestamp":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the sub-account stops being active, as YYYY-MM-DD HH:MM:SS. Must be later than start_timestamp and within 25 years of now. Leave null for no end."},"children":[]}]}]}],"examples":[null]},"create_defaults":{"type":"boolean","description":"Whether to populate the new sub-account with the default statuses, forms and templates a usable account needs. Leave it off only when the account is going to be filled from elsewhere. Create only.","examples":[true]},"locale":{"type":"string","description":"Language the new sub-account starts in, as a locale code such as en or fr. Also becomes the only language available in it until more are added. Create only.","examples":[null]},"custom_*":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A custom attribute, named by its code - custom_shirt_size, for example. The value follows the attribute's own type, so it may be a string, a number, a boolean or a list. See the custom attributes documentation."},"children":[]}]}]}],"examples":[null]}},"required":["name"]},"id":"schema_298"},"schema_299":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[20101]},"parent_id":{"type":"integer","examples":[1]},"account_type_id":{"type":"integer","examples":[3]},"path":{"type":"string","examples":["1/20101"]},"name":{"type":"string","examples":["Example Organisation"]},"config":{"type":"object","properties":{"active_settings":{"type":"array","items":{"type":"string"},"examples":[["general:locale","general:timezone","general:country","users:login","users:register","users:require_dob","event:shift_status_default","event:self_checkin","branding:name","branding:primary_color"]]}}},"meta":{"type":"array","examples":[[]]},"visibility_rules":{"type":"array","examples":[[]]},"status":{"type":"string","examples":["approved"]},"status_reason":{"type":["string","null"],"examples":[null]},"sort_order":{"type":"integer","examples":[0]},"start_timestamp":{"type":["string","null"],"examples":[null]},"end_timestamp":{"type":["string","null"],"examples":[null]},"notes":{"type":["string","null"],"examples":[null]},"contact_firstname":{"type":["string","null"],"examples":[null]},"contact_lastname":{"type":["string","null"],"examples":[null]},"contact_email":{"type":["string","null"],"examples":[null]},"contact_phone":{"type":["string","null"],"examples":[null]},"support_manager_email":{"type":"string","examples":["support.manager@example.com"]},"allow_deletion_request":{"type":"integer","examples":[1]},"organization_type":{"type":["string","null"],"examples":[null]},"contract_start_date":{"type":"string","examples":["2026-06-09"]},"contract_end_date":{"type":"string","examples":["2027-06-09"]},"billing_contact_email":{"type":"string","examples":["billing@example.com"]},"billing_support_email":{"type":"string","examples":["billing.support@example.com"]},"is_enabled":{"type":"integer","examples":[1]},"additional_billing_support_email":{"type":"string","examples":["billing.additional@example.com"]},"delete_requested_at":{"type":["string","null"],"examples":[null]},"is_archived":{"type":"integer","examples":[0]},"trial_ends_at":{"type":["string","null"],"examples":[null]},"can_erase":{"type":"integer","examples":[0]},"deleted_at":{"type":["string","null"],"examples":[null]},"is_erased":{"type":"integer","examples":[0]},"created_at":{"type":"string","examples":["2026-06-09T05:33:32.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T07:08:01.000000Z"]},"domain":{"type":"array","items":{"type":"string"},"examples":[["example.rosterfy.com"]]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:1:account:20101"]},"address":{"type":"string","examples":["No Address"]},"address_oneline":{"type":"string","examples":["No Address"]},"account_type_id":{"type":"integer","examples":[3]},"account_type_id:value":{"type":"integer","examples":[3]},"account_type_id:array":{"type":"integer","examples":[3]},"allow_deletion_request":{"type":"string","examples":["Yes"]},"contact_firstname":{"type":"string","examples":[""]},"contact_lastname":{"type":"string","examples":[""]},"contact_phone:qr_code_value":{"type":"string","examples":[""]},"contact_phone":{"type":"string","examples":[""]},"contact_phone:raw":{"type":"string","examples":[""]},"contract_end_date":{"type":"string","examples":["Jun 9, 2027"]},"contract_end_date__dayofweek":{"type":"string","examples":["Wednesday"]},"contract_start_date":{"type":"string","examples":["Jun 9, 2026"]},"contract_start_date__dayofweek":{"type":"string","examples":["Tuesday"]},"name":{"type":"string","examples":["Example Organisation"]},"notes":{"type":"string","examples":[""]},"organization_type":{"type":["string","null"],"examples":[null]},"organization_type:value":{"type":["string","null"],"examples":[null]},"organization_type:array":{"type":["string","null"],"examples":[null]},"status":{"type":"string","examples":["Approved"]},"status:value":{"type":"string","examples":["approved"]},"status:array":{"type":"string","examples":["approved"]},"status_reason":{"type":"string","examples":[""]},"created_at":{"type":"string","examples":["2026-06-09 05:33:32"]},"url":{"type":"string","examples":["https://example.rosterfy.com/"]},"branding_name":{"type":"string","examples":["Example Organisation"]},"branding_subtitle":{"type":["string","null"],"examples":[null]},"branding_logo":{"type":["string","null"],"examples":[null]},"branding_logo_mono":{"type":["string","null"],"examples":[null]},"branding_logo_stacked":{"type":["string","null"],"examples":[null]},"branding_banner":{"type":["string","null"],"examples":[null]},"branding_favicon":{"type":["string","null"],"examples":[null]},"branding_description":{"type":["string","null"],"examples":[null]},"branding_primary_color":{"type":"string","examples":["#3131c7"]},"branding_complimentary_color":{"type":["string","null"],"examples":[null]},"branding_secondary_color":{"type":"string","examples":["#38b6ff"]},"register":{"type":"boolean","examples":[false]},"organisation_contact":{"type":"string","examples":[" "]},"has_subaccount_approved_email_template":{"type":"boolean","examples":[false]},"has_subaccount_rejected_email_template":{"type":"boolean","examples":[false]},"parent_account_name":{"type":"string","examples":["Example Parent Organisation"]}}},"relations":{"type":"object","properties":{"current_user_checkpoint":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[3]},"user_checkpoint_type_id":{"type":["string","null"],"examples":[null]},"name":{"type":"string","examples":["Default"]},"label":{"type":"string","examples":["default"]},"permissions":{"type":"object","properties":{"all":{"type":"string","examples":["1"]}}},"actions":{"type":"array","examples":[[]]},"is_inheritable":{"type":"integer","examples":[0]},"sort_order":{"type":"integer","examples":[0]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-06-09T05:33:39.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:34:24.000000Z"]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:checkpoint:3"]},"content_id":{"type":"integer","examples":[3]},"account_name_path":{"type":"string","examples":["Example Organisation"]},"is_foreign_account":{"type":"boolean","examples":[false]}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[false]}}}}},"parent":{"type":"array","examples":[[]]},"account":{"type":"array","examples":[[]]}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[false]},"delete":{"type":"boolean","examples":[false]},"apply":{"type":"boolean","examples":[false]},"apply_error":{"type":"string","examples":["Subaccount does not allow User to join"]},"view_subaccount_selection_menu":{"type":"boolean","examples":[false]}}},"attributes":{"type":"object","properties":{}}},"examples":[{"object":{"id":20101,"parent_id":1,"account_type_id":3,"path":"1/20101","name":"Example Organisation","config":{"active_settings":["general:locale","general:timezone","general:country","users:login","users:register","users:require_dob","event:shift_status_default","event:self_checkin","branding:name","branding:primary_color"]},"meta":[],"visibility_rules":[],"status":"approved","status_reason":null,"sort_order":0,"start_timestamp":null,"end_timestamp":null,"notes":null,"contact_firstname":null,"contact_lastname":null,"contact_email":null,"contact_phone":null,"support_manager_email":"support.manager@example.com","allow_deletion_request":1,"organization_type":null,"contract_start_date":"2026-06-09","contract_end_date":"2027-06-09","billing_contact_email":"billing@example.com","billing_support_email":"billing.support@example.com","is_enabled":1,"additional_billing_support_email":"billing.additional@example.com","delete_requested_at":null,"is_archived":0,"trial_ends_at":null,"can_erase":0,"deleted_at":null,"is_erased":0,"created_at":"2026-06-09T05:33:32.000000Z","updated_at":"2026-06-09T07:08:01.000000Z","domain":["example.rosterfy.com"]},"nice":{"rrn":"rrn:local:1:account:20101","address":"No Address","address_oneline":"No Address","account_type_id":3,"account_type_id:value":3,"account_type_id:array":3,"allow_deletion_request":"Yes","contact_firstname":"","contact_lastname":"","contact_phone:qr_code_value":"","contact_phone":"","contact_phone:raw":"","contract_end_date":"Jun 9, 2027","contract_end_date__dayofweek":"Wednesday","contract_start_date":"Jun 9, 2026","contract_start_date__dayofweek":"Tuesday","name":"Example Organisation","notes":"","organization_type":null,"organization_type:value":null,"organization_type:array":null,"status":"Approved","status:value":"approved","status:array":"approved","status_reason":"","created_at":"2026-06-09 05:33:32","url":"https://example.rosterfy.com/","branding_name":"Example Organisation","branding_subtitle":null,"branding_logo":null,"branding_logo_mono":null,"branding_logo_stacked":null,"branding_banner":null,"branding_favicon":null,"branding_description":null,"branding_primary_color":"#3131c7","branding_complimentary_color":null,"branding_secondary_color":"#38b6ff","register":false,"organisation_contact":" ","has_subaccount_approved_email_template":false,"has_subaccount_rejected_email_template":false,"parent_account_name":"Example Parent Organisation"},"relations":{"current_user_checkpoint":{"object":{"id":3,"user_checkpoint_type_id":null,"name":"Default","label":"default","permissions":{"all":"1"},"actions":[],"is_inheritable":0,"sort_order":0,"deleted_at":null,"created_at":"2026-06-09T05:33:39.000000Z","updated_at":"2026-06-09T05:34:24.000000Z"},"nice":{"rrn":"rrn:local:20101:checkpoint:3","content_id":3,"account_name_path":"Example Organisation","is_foreign_account":false},"permissions":{"read":true,"update":true,"delete":false}},"parent":[],"account":[]},"permissions":{"read":true,"update":false,"delete":false,"apply":false,"apply_error":"Subaccount does not allow User to join","view_subaccount_selection_menu":false},"attributes":{}}]},"id":"schema_299"},"schema_300":{"kind":"json-schema","data":{"type":"integer","examples":[20101]},"id":"schema_300"},"schema_301":{"kind":"json-schema","data":{"type":"object","properties":{"name":{"type":"string","description":"Display name of the sub-account, up to 255 characters. This is what people see in the account switcher and in anything branded with the account name.","examples":["Example Organisation"]},"meta":{"type":"object","description":"","properties":{"publish":{"type":"boolean","description":"Whether the sub-account is listed to people browsing the sub-accounts they could join. Unpublished accounts stay reachable by direct link.","examples":[true]},"hide_from_new_applicants":{"type":"boolean","description":"Whether to keep the sub-account out of the list someone sees while registering. It stays visible to people who already have an account.","examples":[true]},"promote":{"type":"boolean","description":"Whether to feature the sub-account ahead of the others. The number of promoted accounts an account may have at once is capped, and exceeding it is rejected.","examples":[true]},"join":{"type":"boolean","description":"Whether people may join this sub-account themselves rather than being added to it.","examples":[true]}},"examples":[{"publish":true}]},"visibility_rules":{"type":"array","description":"Optional conditions narrowing which people may see or join this sub-account. Structure is not part of the contract and is not validated - build the rules in the admin console and send back what a read returns. Send an empty array to clear them.","items":{"type":"object"},"examples":[[]]},"sort_order":{"type":"integer","description":"Position of the sub-account in lists that show a group of them together. Lower sorts first; accounts sharing a value fall back to name order.","examples":[0]},"start_timestamp":{"type":"string","description":"When the sub-account becomes active, as YYYY-MM-DD HH:MM:SS. Must be within 25 years either side of now. Leave null for an account that is active immediately.","examples":[null]},"end_timestamp":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the sub-account stops being active, as YYYY-MM-DD HH:MM:SS. Must be later than start_timestamp and within 25 years of now. Leave null for no end."},"children":[]}]}]}],"examples":[null]},"is_archived":{"type":"boolean","description":"Whether the account is archived. An archived account keeps its data but is hidden from the places an active one appears. Update only.","examples":[0]},"custom_*":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A custom attribute, named by its code - custom_shirt_size, for example. The value follows the attribute's own type, so it may be a string, a number, a boolean or a list. See the custom attributes documentation."},"children":[]}]}]}],"examples":[null]}}},"id":"schema_301"},"schema_302":{"kind":"json-schema","data":{"oneOf":[{"description":"the update was queued","type":"object","properties":{"queue":{"type":"string","examples":["mTsVQ1NCLS3vg7WwP5kG1Vbt"]}},"examples":[{"queue":"mTsVQ1NCLS3vg7WwP5kG1Vbt"}]},{"description":"","type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[20101]},"parent_id":{"type":"integer","examples":[1]},"account_type_id":{"type":"integer","examples":[3]},"path":{"type":"string","examples":["1/20101"]},"name":{"type":"string","examples":["Example Organisation"]},"config":{"type":"object","properties":{"active_settings":{"type":"array","items":{"type":"string"},"examples":[["general:locale","general:timezone","general:country","users:login","users:register","users:require_dob","event:shift_status_default","event:self_checkin","branding:name","branding:primary_color"]]}}},"meta":{"type":"array","examples":[[]]},"visibility_rules":{"type":"array","examples":[[]]},"status":{"type":"string","examples":["approved"]},"status_reason":{"type":["string","null"],"examples":[null]},"sort_order":{"type":"integer","examples":[0]},"start_timestamp":{"type":["string","null"],"examples":[null]},"end_timestamp":{"type":["string","null"],"examples":[null]},"notes":{"type":["string","null"],"examples":[null]},"contact_firstname":{"type":["string","null"],"examples":[null]},"contact_lastname":{"type":["string","null"],"examples":[null]},"contact_email":{"type":["string","null"],"examples":[null]},"contact_phone":{"type":["string","null"],"examples":[null]},"support_manager_email":{"type":"string","examples":["support.manager@example.com"]},"allow_deletion_request":{"type":"integer","examples":[1]},"organization_type":{"type":["string","null"],"examples":[null]},"contract_start_date":{"type":"string","examples":["2026-06-09"]},"contract_end_date":{"type":"string","examples":["2027-06-09"]},"billing_contact_email":{"type":"string","examples":["billing@example.com"]},"billing_support_email":{"type":"string","examples":["billing.support@example.com"]},"is_enabled":{"type":"integer","examples":[1]},"additional_billing_support_email":{"type":"string","examples":["billing.additional@example.com"]},"delete_requested_at":{"type":["string","null"],"examples":[null]},"is_archived":{"type":"integer","examples":[0]},"trial_ends_at":{"type":["string","null"],"examples":[null]},"can_erase":{"type":"integer","examples":[0]},"deleted_at":{"type":["string","null"],"examples":[null]},"is_erased":{"type":"integer","examples":[0]},"created_at":{"type":"string","examples":["2026-06-09T05:33:32.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T07:08:01.000000Z"]},"domain":{"type":"array","items":{"type":"string"},"examples":[["example.rosterfy.com"]]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:1:account:20101"]},"address":{"type":"string","examples":["No Address"]},"address_oneline":{"type":"string","examples":["No Address"]},"account_type_id":{"type":"integer","examples":[3]},"account_type_id:value":{"type":"integer","examples":[3]},"account_type_id:array":{"type":"integer","examples":[3]},"allow_deletion_request":{"type":"string","examples":["Yes"]},"contact_firstname":{"type":"string","examples":[""]},"contact_lastname":{"type":"string","examples":[""]},"contact_phone:qr_code_value":{"type":"string","examples":[""]},"contact_phone":{"type":"string","examples":[""]},"contact_phone:raw":{"type":"string","examples":[""]},"contract_end_date":{"type":"string","examples":["Jun 9, 2027"]},"contract_end_date__dayofweek":{"type":"string","examples":["Wednesday"]},"contract_start_date":{"type":"string","examples":["Jun 9, 2026"]},"contract_start_date__dayofweek":{"type":"string","examples":["Tuesday"]},"name":{"type":"string","examples":["Example Organisation"]},"notes":{"type":"string","examples":[""]},"organization_type":{"type":["string","null"],"examples":[null]},"organization_type:value":{"type":["string","null"],"examples":[null]},"organization_type:array":{"type":["string","null"],"examples":[null]},"status":{"type":"string","examples":["Approved"]},"status:value":{"type":"string","examples":["approved"]},"status:array":{"type":"string","examples":["approved"]},"status_reason":{"type":"string","examples":[""]},"created_at":{"type":"string","examples":["2026-06-09 05:33:32"]},"url":{"type":"string","examples":["https://example.rosterfy.com/"]},"branding_name":{"type":"string","examples":["Example Organisation"]},"branding_subtitle":{"type":["string","null"],"examples":[null]},"branding_logo":{"type":["string","null"],"examples":[null]},"branding_logo_mono":{"type":["string","null"],"examples":[null]},"branding_logo_stacked":{"type":["string","null"],"examples":[null]},"branding_banner":{"type":["string","null"],"examples":[null]},"branding_favicon":{"type":["string","null"],"examples":[null]},"branding_description":{"type":["string","null"],"examples":[null]},"branding_primary_color":{"type":"string","examples":["#3131c7"]},"branding_complimentary_color":{"type":["string","null"],"examples":[null]},"branding_secondary_color":{"type":"string","examples":["#38b6ff"]},"register":{"type":"boolean","examples":[false]},"organisation_contact":{"type":"string","examples":[" "]},"has_subaccount_approved_email_template":{"type":"boolean","examples":[false]},"has_subaccount_rejected_email_template":{"type":"boolean","examples":[false]},"parent_account_name":{"type":"string","examples":["Example Parent Organisation"]}}},"relations":{"type":"object","properties":{"current_user_checkpoint":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[3]},"user_checkpoint_type_id":{"type":["string","null"],"examples":[null]},"name":{"type":"string","examples":["Default"]},"label":{"type":"string","examples":["default"]},"permissions":{"type":"object","properties":{"all":{"type":"string","examples":["1"]}}},"actions":{"type":"array","examples":[[]]},"is_inheritable":{"type":"integer","examples":[0]},"sort_order":{"type":"integer","examples":[0]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-06-09T05:33:39.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:34:24.000000Z"]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:checkpoint:3"]},"content_id":{"type":"integer","examples":[3]},"account_name_path":{"type":"string","examples":["Example Organisation"]},"is_foreign_account":{"type":"boolean","examples":[false]}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[false]}}}}},"parent":{"type":"array","examples":[[]]},"account":{"type":"array","examples":[[]]}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[false]},"delete":{"type":"boolean","examples":[false]},"apply":{"type":"boolean","examples":[false]},"apply_error":{"type":"string","examples":["Subaccount does not allow User to join"]},"view_subaccount_selection_menu":{"type":"boolean","examples":[false]}}},"attributes":{"type":"object","properties":{}}},"examples":[{"object":{"id":20101,"parent_id":1,"account_type_id":3,"path":"1/20101","name":"Example Organisation","config":{"active_settings":["general:locale","general:timezone","general:country","users:login","users:register","users:require_dob","event:shift_status_default","event:self_checkin","branding:name","branding:primary_color"]},"meta":[],"visibility_rules":[],"status":"approved","status_reason":null,"sort_order":0,"start_timestamp":null,"end_timestamp":null,"notes":null,"contact_firstname":null,"contact_lastname":null,"contact_email":null,"contact_phone":null,"support_manager_email":"support.manager@example.com","allow_deletion_request":1,"organization_type":null,"contract_start_date":"2026-06-09","contract_end_date":"2027-06-09","billing_contact_email":"billing@example.com","billing_support_email":"billing.support@example.com","is_enabled":1,"additional_billing_support_email":"billing.additional@example.com","delete_requested_at":null,"is_archived":0,"trial_ends_at":null,"can_erase":0,"deleted_at":null,"is_erased":0,"created_at":"2026-06-09T05:33:32.000000Z","updated_at":"2026-06-09T07:08:01.000000Z","domain":["example.rosterfy.com"]},"nice":{"rrn":"rrn:local:1:account:20101","address":"No Address","address_oneline":"No Address","account_type_id":3,"account_type_id:value":3,"account_type_id:array":3,"allow_deletion_request":"Yes","contact_firstname":"","contact_lastname":"","contact_phone:qr_code_value":"","contact_phone":"","contact_phone:raw":"","contract_end_date":"Jun 9, 2027","contract_end_date__dayofweek":"Wednesday","contract_start_date":"Jun 9, 2026","contract_start_date__dayofweek":"Tuesday","name":"Example Organisation","notes":"","organization_type":null,"organization_type:value":null,"organization_type:array":null,"status":"Approved","status:value":"approved","status:array":"approved","status_reason":"","created_at":"2026-06-09 05:33:32","url":"https://example.rosterfy.com/","branding_name":"Example Organisation","branding_subtitle":null,"branding_logo":null,"branding_logo_mono":null,"branding_logo_stacked":null,"branding_banner":null,"branding_favicon":null,"branding_description":null,"branding_primary_color":"#3131c7","branding_complimentary_color":null,"branding_secondary_color":"#38b6ff","register":false,"organisation_contact":" ","has_subaccount_approved_email_template":false,"has_subaccount_rejected_email_template":false,"parent_account_name":"Example Parent Organisation"},"relations":{"current_user_checkpoint":{"object":{"id":3,"user_checkpoint_type_id":null,"name":"Default","label":"default","permissions":{"all":"1"},"actions":[],"is_inheritable":0,"sort_order":0,"deleted_at":null,"created_at":"2026-06-09T05:33:39.000000Z","updated_at":"2026-06-09T05:34:24.000000Z"},"nice":{"rrn":"rrn:local:20101:checkpoint:3","content_id":3,"account_name_path":"Example Organisation","is_foreign_account":false},"permissions":{"read":true,"update":true,"delete":false}},"parent":[],"account":[]},"permissions":{"read":true,"update":false,"delete":false,"apply":false,"apply_error":"Subaccount does not allow User to join","view_subaccount_selection_menu":false},"attributes":{}}]}]},"id":"schema_302"},"schema_303":{"kind":"json-schema","data":{"type":"array","items":{"type":"object","properties":{"current_page":{"type":"integer","examples":[1]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[5]},"name":{"type":"string","examples":["Example Role"]},"code":{"type":"string","examples":["example-role"]},"permissions":{"type":"object","properties":{"account":{"type":"boolean","examples":[true]},"account:read":{"type":"boolean","examples":[true]},"account:update":{"type":"boolean","examples":[true]},"event":{"type":"boolean","examples":[true]},"event:read":{"type":"boolean","examples":[true]},"event:create":{"type":"boolean","examples":[true]},"event:update":{"type":"boolean","examples":[true]},"user":{"type":"boolean","examples":[true]},"user:read":{"type":"boolean","examples":[true]},"user:update":{"type":"boolean","examples":[true]},"report":{"type":"boolean","examples":[true]},"report:read":{"type":"boolean","examples":[true]}}},"horizontal":{"type":["string","null"],"examples":[null]},"prefill":{"type":["string","null"],"examples":[null]},"is_system":{"type":"integer","examples":[1]},"is_lite_admin":{"type":"integer","examples":[0]},"is_simple_attribute_selection":{"type":"integer","examples":[0]},"is_restricted":{"type":"integer","examples":[0]},"is_inheritable":{"type":"integer","examples":[0]},"access_required_modules":{"type":["string","null"],"examples":[null]},"options":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-06-09T05:33:39.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:33:39.000000Z"]},"user_dashboard_id":{"type":["string","null"],"examples":[null]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:role:5"]}}},"relations":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[false]},"delete":{"type":"boolean","examples":[false]},"update_message":{"type":"string","examples":["You cannot update a role you are assigned to."]},"copy":{"type":"boolean","examples":[true]}}}}},"examples":[[{"object":{"id":5,"name":"Example Role","code":"example-role","permissions":{"account":true,"account:read":true,"account:update":true,"event":true,"event:read":true,"event:create":true,"event:update":true,"user":true,"user:read":true,"user:update":true,"report":true,"report:read":true},"horizontal":null,"prefill":null,"is_system":1,"is_lite_admin":0,"is_simple_attribute_selection":0,"is_restricted":0,"is_inheritable":0,"access_required_modules":null,"options":null,"created_at":"2026-06-09T05:33:39.000000Z","updated_at":"2026-06-09T05:33:39.000000Z","user_dashboard_id":null},"nice":{"rrn":"rrn:local:20101:role:5"},"relations":[],"permissions":{"read":true,"update":false,"delete":false,"update_message":"You cannot update a role you are assigned to.","copy":true}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}]]},"first_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/account/role?per_page=5&_locale=en-US&page=1"]},"from":{"type":"integer","examples":[1]},"next_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/account/role?per_page=5&_locale=en-US&page=2"]},"path":{"type":"string","examples":["https://example.rosterfy.com/api/v2/account/role"]},"per_page":{"type":"integer","examples":[5]},"prev_page_url":{"type":["string","null"],"examples":[null]},"to":{"type":"integer","examples":[5]}}},"examples":[[{"current_page":1,"data":[{"object":{"id":5,"name":"Example Role","code":"example-role","permissions":{"account":true,"account:read":true,"account:update":true,"event":true,"event:read":true,"event:create":true,"event:update":true,"user":true,"user:read":true,"user:update":true,"report":true,"report:read":true},"horizontal":null,"prefill":null,"is_system":1,"is_lite_admin":0,"is_simple_attribute_selection":0,"is_restricted":0,"is_inheritable":0,"access_required_modules":null,"options":null,"created_at":"2026-06-09T05:33:39.000000Z","updated_at":"2026-06-09T05:33:39.000000Z","user_dashboard_id":null},"nice":{"rrn":"rrn:local:20101:role:5"},"relations":[],"permissions":{"read":true,"update":false,"delete":false,"update_message":"You cannot update a role you are assigned to.","copy":true}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}],"first_page_url":"https://example.rosterfy.com/api/v2/account/role?per_page=5&_locale=en-US&page=1","from":1,"next_page_url":"https://example.rosterfy.com/api/v2/account/role?per_page=5&_locale=en-US&page=2","path":"https://example.rosterfy.com/api/v2/account/role","per_page":5,"prev_page_url":null,"to":5}]]},"id":"schema_303"},"schema_304":{"kind":"json-schema","data":{"type":"object","properties":{"name":{"type":"string","description":"Display name of the role, up to 255 characters. This is what administrators pick from when assigning someone a role.","examples":["Example Role"]},"permissions":{"type":"object","description":"What the role may do, as an object of permission names against true or false. The set of names is the account's own and is not enumerated here - read an existing role to see the ones available to you, and send the same shape back. A role cannot be given a permission the caller's own role does not hold; attempting it is rejected.","properties":{},"examples":[{"account":true,"account:read":true,"account:update":true,"event":true,"event:read":true,"event:create":true,"event:update":true,"user":true,"user:read":true,"user:update":true,"report":true,"report:read":true}]},"horizontal":{"type":"object","description":"Optional limits on which records the role may act on, as an object keyed by the area being limited. Structure is not part of the contract - build the limits in the admin console and send back what a read returns. Entries naming an area the role has no permission for are dropped rather than rejected, so a role can come back with fewer limits than were sent.","properties":{},"examples":["{}"]},"prefill":{"type":"array","description":"Optional values to fill in automatically on records this role creates. Structure is not part of the contract - build it in the admin console and send back what a read returns. Each attribute may appear only once.","items":{"type":"array","description":"","items":{"type":"object"},"examples":[null]},"examples":[[]]},"is_lite_admin":{"type":"boolean","description":"Whether the role is a lite administrator, a reduced role whose permissions are limited to a fixed subset. Setting it discards any permission outside that subset rather than rejecting the request.","examples":[0]},"is_inheritable":{"type":"boolean","description":"Whether accounts below this one may use the role as well as the account that owns it.","examples":[0]},"code":{"type":"string","description":"Stable identifier for the role, up to 64 characters of letters, digits, hyphens and underscores; anything else is stripped. Use it to map the role to one in your identity provider when signing in through SSO. Must be unique within the account, and one is generated if you leave it empty.","examples":["example-role"]},"is_simple_attribute_selection":{"type":"boolean","description":"Whether the admin console offers this role the simplified attribute picker instead of the full one.","examples":[0]},"options":{"type":"object","description":"","properties":{"protect_pii":{"type":"boolean","description":"Whether people with this role are blocked from seeing private fields on a record. Requires the account to have role-based field protection enabled.","examples":[true]},"protect_pii_all":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether the block covers every private field rather than a chosen list. Only applies when options.protect_pii is set."},"children":[]}]}]}],"examples":[true]},"protect_pii_by_field":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Which fields to block, as a list of attribute codes. Used only when options.protect_pii is set and options.protect_pii_all is not."},"children":[]}]}]}],"items":{"type":"string"},"examples":[[]]},"mask_pii":{"type":"boolean","description":"Whether private fields are shown to this role with their values obscured rather than hidden outright. Requires the account to have role-based field masking enabled.","examples":[true]},"mask_pii_all":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether masking covers every private field rather than a chosen list. Only applies when options.mask_pii is set."},"children":[]}]}]}],"examples":[true]},"mask_pii_by_field":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Which fields to mask, as a list of attribute codes. Used only when options.mask_pii is set and options.mask_pii_all is not."},"children":[]}]}]}],"items":{"type":"string"},"examples":[[]]}},"examples":[{"protect_pii":true}]}},"required":["name","permissions","code"]},"id":"schema_304"},"schema_305":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[5]},"name":{"type":"string","examples":["Example Role"]},"code":{"type":"string","examples":["example-role"]},"permissions":{"type":"object","properties":{"account":{"type":"boolean","examples":[true]},"account:read":{"type":"boolean","examples":[true]},"account:update":{"type":"boolean","examples":[true]},"event":{"type":"boolean","examples":[true]},"event:read":{"type":"boolean","examples":[true]},"event:create":{"type":"boolean","examples":[true]},"event:update":{"type":"boolean","examples":[true]},"user":{"type":"boolean","examples":[true]},"user:read":{"type":"boolean","examples":[true]},"user:update":{"type":"boolean","examples":[true]},"report":{"type":"boolean","examples":[true]},"report:read":{"type":"boolean","examples":[true]}}},"horizontal":{"type":["string","null"],"examples":[null]},"prefill":{"type":["string","null"],"examples":[null]},"is_system":{"type":"integer","examples":[1]},"is_lite_admin":{"type":"integer","examples":[0]},"is_simple_attribute_selection":{"type":"integer","examples":[0]},"is_restricted":{"type":"integer","examples":[0]},"is_inheritable":{"type":"integer","examples":[0]},"access_required_modules":{"type":["string","null"],"examples":[null]},"options":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-06-09T05:33:39.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:33:39.000000Z"]},"user_dashboard_id":{"type":["string","null"],"examples":[null]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:role:5"]}}},"relations":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[false]},"delete":{"type":"boolean","examples":[false]},"update_message":{"type":"string","examples":["You cannot update a role you are assigned to."]},"copy":{"type":"boolean","examples":[true]}}}},"examples":[{"object":{"id":5,"name":"Example Role","code":"example-role","permissions":{"account":true,"account:read":true,"account:update":true,"event":true,"event:read":true,"event:create":true,"event:update":true,"user":true,"user:read":true,"user:update":true,"report":true,"report:read":true},"horizontal":null,"prefill":null,"is_system":1,"is_lite_admin":0,"is_simple_attribute_selection":0,"is_restricted":0,"is_inheritable":0,"access_required_modules":null,"options":null,"created_at":"2026-06-09T05:33:39.000000Z","updated_at":"2026-06-09T05:33:39.000000Z","user_dashboard_id":null},"nice":{"rrn":"rrn:local:20101:role:5"},"relations":[],"permissions":{"read":true,"update":false,"delete":false,"update_message":"You cannot update a role you are assigned to.","copy":true}}]},"id":"schema_305"},"schema_306":{"kind":"json-schema","data":{"type":"integer","examples":[5]},"id":"schema_306"},"schema_307":{"kind":"json-schema","data":{"type":"object","properties":{"name":{"type":"string","description":"Display name of the role, up to 255 characters. This is what administrators pick from when assigning someone a role.","examples":["Example Role"]},"permissions":{"type":"object","description":"What the role may do, as an object of permission names against true or false. The set of names is the account's own and is not enumerated here - read an existing role to see the ones available to you, and send the same shape back. A role cannot be given a permission the caller's own role does not hold; attempting it is rejected.","properties":{},"examples":[{"account":true,"account:read":true,"account:update":true,"event":true,"event:read":true,"event:create":true,"event:update":true,"user":true,"user:read":true,"user:update":true,"report":true,"report:read":true}]},"horizontal":{"type":"object","description":"Optional limits on which records the role may act on, as an object keyed by the area being limited. Structure is not part of the contract - build the limits in the admin console and send back what a read returns. Entries naming an area the role has no permission for are dropped rather than rejected, so a role can come back with fewer limits than were sent.","properties":{},"examples":["{}"]},"prefill":{"type":"array","description":"Optional values to fill in automatically on records this role creates. Structure is not part of the contract - build it in the admin console and send back what a read returns. Each attribute may appear only once.","items":{"type":"array","description":"","items":{"type":"object"},"examples":[null]},"examples":[[]]},"is_lite_admin":{"type":"boolean","description":"Whether the role is a lite administrator, a reduced role whose permissions are limited to a fixed subset. Setting it discards any permission outside that subset rather than rejecting the request.","examples":[0]},"code":{"type":"string","description":"Stable identifier for the role, up to 64 characters of letters, digits, hyphens and underscores; anything else is stripped. Use it to map the role to one in your identity provider when signing in through SSO. Must be unique within the account, and one is generated if you leave it empty.","examples":["example-role"]},"is_simple_attribute_selection":{"type":"boolean","description":"Whether the admin console offers this role the simplified attribute picker instead of the full one.","examples":[0]},"is_restricted":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether the role is limited to specific records within the areas named in access_required_modules, chosen per person rather than per role. Update only."},"children":[]}]}]}],"examples":[0]},"is_inheritable":{"type":"boolean","description":"Whether accounts below this one may use the role as well as the account that owns it.","examples":[0]},"access_required_modules":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Which areas the per-person limits apply to, as a list of area names: headcount_functional_area, headcount_functional_area_job_title, headcount_location, headcount_location_venue or headcount_user_type. Cleared unless is_restricted is set. Update only."},"children":[]}]}]}],"items":{"type":"string"},"examples":[[]]},"options":{"type":"object","description":"","properties":{"protect_pii":{"type":"boolean","description":"Whether people with this role are blocked from seeing private fields on a record. Requires the account to have role-based field protection enabled.","examples":[true]},"protect_pii_all":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether the block covers every private field rather than a chosen list. Only applies when options.protect_pii is set."},"children":[]}]}]}],"examples":[true]},"protect_pii_by_field":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Which fields to block, as a list of attribute codes. Used only when options.protect_pii is set and options.protect_pii_all is not."},"children":[]}]}]}],"items":{"type":"string"},"examples":[[]]},"mask_pii":{"type":"boolean","description":"Whether private fields are shown to this role with their values obscured rather than hidden outright. Requires the account to have role-based field masking enabled.","examples":[true]},"mask_pii_all":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether masking covers every private field rather than a chosen list. Only applies when options.mask_pii is set."},"children":[]}]}]}],"examples":[true]},"mask_pii_by_field":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Which fields to mask, as a list of attribute codes. Used only when options.mask_pii is set and options.mask_pii_all is not."},"children":[]}]}]}],"items":{"type":"string"},"examples":[[]]}},"examples":[{"protect_pii":true}]}}},"id":"schema_307"},"schema_308":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","examples":["You cannot update a role you are assigned to."]}},"examples":[{"message":"You cannot update a role you are assigned to."}]},"id":"schema_308"},"schema_309":{"kind":"json-schema","data":{"type":"array","items":{"type":"object","properties":{"current_page":{"type":"integer","examples":[1]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[23453473]},"id_token":{"type":"string","examples":["xxxxxxxxxxxxxxxxxxxxxxxx"]},"account_id":{"type":"integer","examples":[20101]},"email":{"type":"string","examples":["jordan.avery@example.com"]},"force_reset_password":{"type":"integer","examples":[0]},"password_expires_at":{"type":["string","null"],"examples":[null]},"first_name":{"type":"string","examples":["Jordan"]},"middle_name":{"type":["string","null"],"examples":[null]},"last_name":{"type":"string","examples":["Avery"]},"preferred_name":{"type":["string","null"],"examples":[null]},"phone":{"type":"string","examples":["au-297809703"]},"dob":{"type":"string","examples":["1990-01-01"]},"picture":{"type":["string","null"],"examples":[null]},"picture_status":{"type":"integer","examples":[0]},"is_subscribed":{"type":"integer","examples":[0]},"is_subscribed_transactional":{"type":"integer","examples":[1]},"is_unreachable":{"type":"integer","examples":[0]},"is_unreachable_sms":{"type":"integer","examples":[0]},"terms":{"type":"integer","examples":[1]},"rating":{"type":"string","examples":["0.00"]},"shift_privacy":{"type":"integer","examples":[1]},"is_team_leader":{"type":"integer","examples":[0]},"email_verified":{"type":"integer","examples":[0]},"login_lockout_attempts":{"type":"integer","examples":[0]},"login_lockout_at":{"type":["string","null"],"examples":[null]},"login_lockout_email_sent_at":{"type":["string","null"],"examples":[null]},"last_login_at":{"type":"string","examples":["2026-08-10T05:16:30.000000Z"]},"last_app_login_at":{"type":["string","null"],"examples":[null]},"is_archived":{"type":"integer","examples":[0]},"last_activated":{"type":["string","null"],"examples":[null]},"from_source":{"type":["string","null"],"examples":[null]},"delete_requested_at":{"type":["string","null"],"examples":[null]},"deleted_at":{"type":["string","null"],"examples":[null]},"is_erased":{"type":"integer","examples":[0]},"created_at":{"type":"string","examples":["2026-06-09T05:33:39.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:33:39.000000Z"]},"deleted_by":{"type":["string","null"],"examples":[null]},"interests":{"type":["string","null"],"examples":[null]},"address":{"type":"object","properties":{"iso":{"type":"string","examples":["AUS"]},"region_code":{"type":"string","examples":["VIC"]},"coordinates":{"type":"object","properties":{"latitude":{"type":["string","null"],"examples":[null]},"longitude":{"type":["string","null"],"examples":[null]}}},"street_address_1":{"type":"string","examples":["1 Example Street"]},"street_address_2":{"type":["string","null"],"examples":[null]},"street_address_3":{"type":["string","null"],"examples":[null]},"city":{"type":"string","examples":["Melbourne"]},"postcode":{"type":"string","examples":["3000"]},"region":{"type":"string","examples":["VIC"]},"country":{"type":"string","examples":["AU"]},"latitude":{"type":["string","null"],"examples":[null]},"longitude":{"type":["string","null"],"examples":[null]}}},"added_at":{"type":"string","examples":["2026-06-09T05:33:39.000000Z"]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:user:xxxxxxxxxxxxxxxxxxxxxxxx"]},"address":{"type":"string","examples":["1 Example Street\nMelbourne\nVictoria\nAustralia\n3000"]},"address_oneline":{"type":"string","examples":["1 Example Street, Melbourne, Victoria, Australia, 3000"]},"address.country":{"type":"string","examples":["Australia"]},"address.country:raw":{"type":"string","examples":["AUS"]},"address.city":{"type":"string","examples":["Melbourne"]},"address.region":{"type":"string","examples":["Victoria"]},"address.region:raw":{"type":"string","examples":["VIC"]},"address.postcode":{"type":"string","examples":["3000"]},"address.street_address_1":{"type":"string","examples":["1 Example Street"]},"address.street_address_2":{"type":["string","null"],"examples":[null]},"address.street_address_3":{"type":["string","null"],"examples":[null]},"address.latitude":{"type":["string","null"],"examples":[null]},"address.longitude":{"type":["string","null"],"examples":[null]},"family_id":{"type":["string","null"],"examples":[null]},"has_family_members":{"type":"string","examples":["No"]},"manages_family":{"type":"boolean","examples":[false]},"family_manager":{"type":"string","examples":["No"]},"family_member":{"type":"string","examples":["No"]},"is_family_member":{"type":"boolean","examples":[false]},"is_engaged":{"type":"string","examples":["No"]},"is_engaged:raw":{"type":"boolean","examples":[false]},"last_engaged_at":{"type":["string","null"],"examples":[null]},"last_engaged_at:raw":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["Jun 9, 2026, 5:33 AM"]},"created_at__date":{"type":"string","examples":["Jun 9, 2026"]},"created_at__time":{"type":"string","examples":["5:33 AM"]},"created_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"created_at__offset_minutes":{"type":"integer","examples":[0]},"created_at__dayofweek":{"type":"string","examples":["Tuesday"]},"email_verified":{"type":"string","examples":["No"]},"from_source":{"type":"string","examples":[""]},"interests":{"type":["string","null"],"examples":[null]},"interests:value":{"type":["string","null"],"examples":[null]},"interests:array":{"type":["string","null"],"examples":[null]},"is_subscribed_transactional":{"type":"string","examples":["Yes"]},"is_team_leader":{"type":"string","examples":["No"]},"last_login_at":{"type":"string","examples":["Aug 10, 2026, 5:16 AM"]},"last_login_at__date":{"type":"string","examples":["Aug 10, 2026"]},"last_login_at__time":{"type":"string","examples":["5:16 AM"]},"last_login_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"last_login_at__offset_minutes":{"type":"integer","examples":[0]},"last_login_at__dayofweek":{"type":"string","examples":["Monday"]},"middle_name":{"type":"string","examples":[""]},"picture_status":{"type":"string","examples":["N/A"]},"picture_status:value":{"type":"integer","examples":[0]},"picture_status:array":{"type":"string","examples":["N/A"]},"shift_privacy":{"type":"string","examples":["Yes"]},"updated_at":{"type":"string","examples":["Jun 9, 2026, 5:33 AM"]},"updated_at__date":{"type":"string","examples":["Jun 9, 2026"]},"updated_at__time":{"type":"string","examples":["5:33 AM"]},"updated_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"updated_at__offset_minutes":{"type":"integer","examples":[0]},"updated_at__dayofweek":{"type":"string","examples":["Tuesday"]},"first_name":{"type":"string","examples":["Jordan"]},"last_name":{"type":"string","examples":["Avery"]},"preferred_name":{"type":"string","examples":[""]},"phone:qr_code_value":{"type":"string","examples":["au-297809703"]},"phone":{"type":"string","examples":["(+61) 297809703"]},"phone:raw":{"type":"string","examples":["+61297809703"]},"phone:local_au":{"type":"string","examples":["0297809703"]},"dob":{"type":"string","examples":["Jan 1, 1990"]},"dob__dayofweek":{"type":"string","examples":["Monday"]},"is_subscribed":{"type":"string","examples":["No"]},"terms":{"type":"string","examples":["Yes"]},"name":{"type":"string","examples":["Jordan Avery"]},"age":{"type":"integer","examples":[36]},"age_months":{"type":"string","examples":["36 years, 7 months"]},"info":{"type":"string","examples":["Jordan Avery (jordan.avery@example.com)"]},"preferred_first_name":{"type":"string","examples":["Jordan"]},"delete_requested":{"type":"boolean","examples":[false]},"updated_hours":{"type":"number","examples":[1583.176031565]},"is_community_user":{"type":"boolean","examples":[false]},"timezone":{"type":"string","examples":["UTC"]}}},"relations":{"type":"object","properties":{"user_checkpoint":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[3]},"user_checkpoint_type_id":{"type":["string","null"],"examples":[null]},"name":{"type":"string","examples":["Default"]},"label":{"type":"string","examples":["default"]},"permissions":{"type":"object","properties":{"all":{"type":"string","examples":["1"]}}},"actions":{"type":"array","examples":[[]]},"is_inheritable":{"type":"integer","examples":[0]},"sort_order":{"type":"integer","examples":[0]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-06-09T05:33:39.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:34:24.000000Z"]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:checkpoint:3"]},"content_id":{"type":"integer","examples":[3]},"account_name_path":{"type":"string","examples":["Example Organisation"]},"is_foreign_account":{"type":"boolean","examples":[false]}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[false]}}}}},"user_type":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[2]},"account_branding_id":{"type":["string","null"],"examples":[null]},"name":{"type":"string","examples":["Default"]},"code":{"type":"string","examples":["default"]},"profile_form_id":{"type":["string","null"],"examples":[null]},"training_ids":{"type":["string","null"],"examples":[null]},"registration_form_id":{"type":["string","null"],"examples":[null]},"shift_limit":{"type":"integer","examples":[0]},"shift_max_time":{"type":["string","null"],"examples":[null]},"max_shift_length":{"type":"integer","examples":[0]},"min_shift_length":{"type":"integer","examples":[0]},"min_consecutive_rest_time_per_week":{"type":"integer","examples":[0]},"max_work_days_per_week":{"type":"integer","examples":[0]},"gap_between_shifts":{"type":"integer","examples":[0]},"group_leader_attributes":{"type":["string","null"],"examples":[null]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-06-09T05:33:39.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:33:39.000000Z"]},"uuid":{"type":"string","examples":["0cdefc27-b599-4a15-a82f-18c11bb44803"]}}},"nice":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[false]}}}}},"account":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[20101]},"parent_id":{"type":"integer","examples":[1]},"account_type_id":{"type":"integer","examples":[3]},"path":{"type":"string","examples":["1/20101"]},"name":{"type":"string","examples":["Example Organisation"]},"config":{"type":"object","properties":{"active_settings":{"type":"array","items":{"type":"string"},"examples":[["general:locale","general:timezone","general:country","users:login","users:register","users:require_dob","event:shift_status_default","event:self_checkin","branding:name","branding:primary_color"]]}}},"meta":{"type":"array","examples":[[]]},"visibility_rules":{"type":"array","examples":[[]]},"status":{"type":"string","examples":["approved"]},"status_reason":{"type":["string","null"],"examples":[null]},"sort_order":{"type":"integer","examples":[0]},"start_timestamp":{"type":["string","null"],"examples":[null]},"end_timestamp":{"type":["string","null"],"examples":[null]},"notes":{"type":["string","null"],"examples":[null]},"contact_firstname":{"type":["string","null"],"examples":[null]},"contact_lastname":{"type":["string","null"],"examples":[null]},"contact_email":{"type":["string","null"],"examples":[null]},"contact_phone":{"type":["string","null"],"examples":[null]},"support_manager_email":{"type":"string","examples":["billing@example.com"]},"allow_deletion_request":{"type":"integer","examples":[1]},"organization_type":{"type":["string","null"],"examples":[null]},"contract_start_date":{"type":"string","examples":["2026-06-09"]},"contract_end_date":{"type":"string","examples":["2027-06-09"]},"billing_contact_email":{"type":"string","examples":["billing@example.com"]},"billing_support_email":{"type":"string","examples":["billing@example.com"]},"is_enabled":{"type":"integer","examples":[1]},"additional_billing_support_email":{"type":"string","examples":["billing@example.com"]},"delete_requested_at":{"type":["string","null"],"examples":[null]},"is_archived":{"type":"integer","examples":[0]},"trial_ends_at":{"type":["string","null"],"examples":[null]},"can_erase":{"type":"integer","examples":[0]},"deleted_at":{"type":["string","null"],"examples":[null]},"is_erased":{"type":"integer","examples":[0]},"created_at":{"type":"string","examples":["2026-06-09T05:33:32.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T07:08:01.000000Z"]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:1:account:20101"]},"address":{"type":"string","examples":["No Address"]},"address_oneline":{"type":"string","examples":["No Address"]},"account_type_id":{"type":"integer","examples":[3]},"account_type_id:value":{"type":"integer","examples":[3]},"account_type_id:array":{"type":"integer","examples":[3]},"allow_deletion_request":{"type":"string","examples":["Yes"]},"contact_firstname":{"type":"string","examples":[""]},"contact_lastname":{"type":"string","examples":[""]},"contact_phone:qr_code_value":{"type":"string","examples":[""]},"contact_phone":{"type":"string","examples":[""]},"contact_phone:raw":{"type":"string","examples":[""]},"contract_end_date":{"type":"string","examples":["Jun 9, 2027"]},"contract_end_date__dayofweek":{"type":"string","examples":["Wednesday"]},"contract_start_date":{"type":"string","examples":["Jun 9, 2026"]},"contract_start_date__dayofweek":{"type":"string","examples":["Tuesday"]},"name":{"type":"string","examples":["Example Organisation"]},"notes":{"type":"string","examples":[""]},"organization_type":{"type":["string","null"],"examples":[null]},"organization_type:value":{"type":["string","null"],"examples":[null]},"organization_type:array":{"type":["string","null"],"examples":[null]},"status":{"type":"string","examples":["Approved"]},"status:value":{"type":"string","examples":["approved"]},"status:array":{"type":"string","examples":["approved"]},"status_reason":{"type":"string","examples":[""]},"created_at":{"type":"string","examples":["2026-06-09 05:33:32"]},"url":{"type":"string","examples":["https://example.rosterfy.com/"]},"branding_name":{"type":"string","examples":["Example Organisation"]},"branding_subtitle":{"type":["string","null"],"examples":[null]},"branding_logo":{"type":["string","null"],"examples":[null]},"branding_logo_mono":{"type":["string","null"],"examples":[null]},"branding_logo_stacked":{"type":["string","null"],"examples":[null]},"branding_banner":{"type":["string","null"],"examples":[null]},"branding_favicon":{"type":["string","null"],"examples":[null]},"branding_description":{"type":["string","null"],"examples":[null]},"branding_primary_color":{"type":"string","examples":["#3131c7"]},"branding_complimentary_color":{"type":["string","null"],"examples":[null]},"branding_secondary_color":{"type":"string","examples":["#38b6ff"]},"register":{"type":"boolean","examples":[false]},"organisation_contact":{"type":"string","examples":[" "]},"has_subaccount_approved_email_template":{"type":"boolean","examples":[false]},"has_subaccount_rejected_email_template":{"type":"boolean","examples":[false]},"parent_account_name":{"type":"string","examples":["Example Parent Organisation"]}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[false]},"delete":{"type":"boolean","examples":[false]}}}}},"family":{"type":["string","null"],"examples":[null]},"family_user":{"type":["string","null"],"examples":[null]}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[false]},"delete":{"type":"boolean","examples":[false]}}},"attributes":{"type":"array","examples":[[]]}}},"examples":[[{"object":{"id":23453473,"id_token":"xxxxxxxxxxxxxxxxxxxxxxxx","account_id":20101,"email":"jordan.avery@example.com","force_reset_password":0,"password_expires_at":null,"first_name":"Jordan","middle_name":null,"last_name":"Avery","preferred_name":null,"phone":"au-297809703","dob":"1990-01-01","picture":null,"picture_status":0,"is_subscribed":0,"is_subscribed_transactional":1,"is_unreachable":0,"is_unreachable_sms":0,"terms":1,"rating":"0.00","shift_privacy":1,"is_team_leader":0,"email_verified":0,"login_lockout_attempts":0,"login_lockout_at":null,"login_lockout_email_sent_at":null,"last_login_at":"2026-08-10T05:16:30.000000Z","last_app_login_at":null,"is_archived":0,"last_activated":null,"from_source":null,"delete_requested_at":null,"deleted_at":null,"is_erased":0,"created_at":"2026-06-09T05:33:39.000000Z","updated_at":"2026-06-09T05:33:39.000000Z","deleted_by":null,"interests":null,"address":{"iso":"AUS","region_code":"VIC","coordinates":{"latitude":null,"longitude":null},"street_address_1":"1 Example Street","street_address_2":null,"street_address_3":null,"city":"Melbourne","postcode":"3000","region":"VIC","country":"AU","latitude":null,"longitude":null},"added_at":"2026-06-09T05:33:39.000000Z"},"nice":{"rrn":"rrn:local:20101:user:xxxxxxxxxxxxxxxxxxxxxxxx","address":"1 Example Street\nMelbourne\nVictoria\nAustralia\n3000","address_oneline":"1 Example Street, Melbourne, Victoria, Australia, 3000","address.country":"Australia","address.country:raw":"AUS","address.city":"Melbourne","address.region":"Victoria","address.region:raw":"VIC","address.postcode":"3000","address.street_address_1":"1 Example Street","address.street_address_2":null,"address.street_address_3":null,"address.latitude":null,"address.longitude":null,"family_id":null,"has_family_members":"No","manages_family":false,"family_manager":"No","family_member":"No","is_family_member":false,"is_engaged":"No","is_engaged:raw":false,"last_engaged_at":null,"last_engaged_at:raw":null,"created_at":"Jun 9, 2026, 5:33 AM","created_at__date":"Jun 9, 2026","created_at__time":"5:33 AM","created_at__offset":" (+00:00 UTC)","created_at__offset_minutes":0,"created_at__dayofweek":"Tuesday","email_verified":"No","from_source":"","interests":null,"interests:value":null,"interests:array":null,"is_subscribed_transactional":"Yes","is_team_leader":"No","last_login_at":"Aug 10, 2026, 5:16 AM","last_login_at__date":"Aug 10, 2026","last_login_at__time":"5:16 AM","last_login_at__offset":" (+00:00 UTC)","last_login_at__offset_minutes":0,"last_login_at__dayofweek":"Monday","middle_name":"","picture_status":"N/A","picture_status:value":0,"picture_status:array":"N/A","shift_privacy":"Yes","updated_at":"Jun 9, 2026, 5:33 AM","updated_at__date":"Jun 9, 2026","updated_at__time":"5:33 AM","updated_at__offset":" (+00:00 UTC)","updated_at__offset_minutes":0,"updated_at__dayofweek":"Tuesday","first_name":"Jordan","last_name":"Avery","preferred_name":"","phone:qr_code_value":"au-297809703","phone":"(+61) 297809703","phone:raw":"+61297809703","phone:local_au":"0297809703","dob":"Jan 1, 1990","dob__dayofweek":"Monday","is_subscribed":"No","terms":"Yes","name":"Jordan Avery","age":36,"age_months":"36 years, 7 months","info":"Jordan Avery (jordan.avery@example.com)","preferred_first_name":"Jordan","delete_requested":false,"updated_hours":1583.176031565,"is_community_user":false,"timezone":"UTC"},"relations":{"user_checkpoint":{"object":{"id":3,"user_checkpoint_type_id":null,"name":"Default","label":"default","permissions":{"all":"1"},"actions":[],"is_inheritable":0,"sort_order":0,"deleted_at":null,"created_at":"2026-06-09T05:33:39.000000Z","updated_at":"2026-06-09T05:34:24.000000Z"},"nice":{"rrn":"rrn:local:20101:checkpoint:3","content_id":3,"account_name_path":"Example Organisation","is_foreign_account":false},"permissions":{"read":true,"update":true,"delete":false}},"user_type":{"object":{"id":2,"account_branding_id":null,"name":"Default","code":"default","profile_form_id":null,"training_ids":null,"registration_form_id":null,"shift_limit":0,"shift_max_time":null,"max_shift_length":0,"min_shift_length":0,"min_consecutive_rest_time_per_week":0,"max_work_days_per_week":0,"gap_between_shifts":0,"group_leader_attributes":null,"deleted_at":null,"created_at":"2026-06-09T05:33:39.000000Z","updated_at":"2026-06-09T05:33:39.000000Z","uuid":"0cdefc27-b599-4a15-a82f-18c11bb44803"},"nice":[],"permissions":{"read":true,"update":true,"delete":false}},"account":{"object":{"id":20101,"parent_id":1,"account_type_id":3,"path":"1/20101","name":"Example Organisation","config":{"active_settings":["general:locale","general:timezone","general:country","users:login","users:register","users:require_dob","event:shift_status_default","event:self_checkin","branding:name","branding:primary_color"]},"meta":[],"visibility_rules":[],"status":"approved","status_reason":null,"sort_order":0,"start_timestamp":null,"end_timestamp":null,"notes":null,"contact_firstname":null,"contact_lastname":null,"contact_email":null,"contact_phone":null,"support_manager_email":"billing@example.com","allow_deletion_request":1,"organization_type":null,"contract_start_date":"2026-06-09","contract_end_date":"2027-06-09","billing_contact_email":"billing@example.com","billing_support_email":"billing@example.com","is_enabled":1,"additional_billing_support_email":"billing@example.com","delete_requested_at":null,"is_archived":0,"trial_ends_at":null,"can_erase":0,"deleted_at":null,"is_erased":0,"created_at":"2026-06-09T05:33:32.000000Z","updated_at":"2026-06-09T07:08:01.000000Z"},"nice":{"rrn":"rrn:local:1:account:20101","address":"No Address","address_oneline":"No Address","account_type_id":3,"account_type_id:value":3,"account_type_id:array":3,"allow_deletion_request":"Yes","contact_firstname":"","contact_lastname":"","contact_phone:qr_code_value":"","contact_phone":"","contact_phone:raw":"","contract_end_date":"Jun 9, 2027","contract_end_date__dayofweek":"Wednesday","contract_start_date":"Jun 9, 2026","contract_start_date__dayofweek":"Tuesday","name":"Example Organisation","notes":"","organization_type":null,"organization_type:value":null,"organization_type:array":null,"status":"Approved","status:value":"approved","status:array":"approved","status_reason":"","created_at":"2026-06-09 05:33:32","url":"https://example.rosterfy.com/","branding_name":"Example Organisation","branding_subtitle":null,"branding_logo":null,"branding_logo_mono":null,"branding_logo_stacked":null,"branding_banner":null,"branding_favicon":null,"branding_description":null,"branding_primary_color":"#3131c7","branding_complimentary_color":null,"branding_secondary_color":"#38b6ff","register":false,"organisation_contact":" ","has_subaccount_approved_email_template":false,"has_subaccount_rejected_email_template":false,"parent_account_name":"Example Parent Organisation"},"permissions":{"read":true,"update":false,"delete":false}},"family":null,"family_user":null},"permissions":{"read":true,"update":false,"delete":false},"attributes":[]},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}]]},"first_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/account/role/{role}/user?per_page=5&_locale=en-US&page=1"]},"from":{"type":"integer","examples":[1]},"next_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/account/role/{role}/user?per_page=5&_locale=en-US&page=2"]},"path":{"type":"string","examples":["https://example.rosterfy.com/api/v2/account/role/{role}/user"]},"per_page":{"type":"integer","examples":[5]},"prev_page_url":{"type":["string","null"],"examples":[null]},"to":{"type":"integer","examples":[5]}}},"examples":[[{"current_page":1,"data":[{"object":{"id":23453473,"id_token":"xxxxxxxxxxxxxxxxxxxxxxxx","account_id":20101,"email":"jordan.avery@example.com","force_reset_password":0,"password_expires_at":null,"first_name":"Jordan","middle_name":null,"last_name":"Avery","preferred_name":null,"phone":"au-297809703","dob":"1990-01-01","picture":null,"picture_status":0,"is_subscribed":0,"is_subscribed_transactional":1,"is_unreachable":0,"is_unreachable_sms":0,"terms":1,"rating":"0.00","shift_privacy":1,"is_team_leader":0,"email_verified":0,"login_lockout_attempts":0,"login_lockout_at":null,"login_lockout_email_sent_at":null,"last_login_at":"2026-08-10T05:16:30.000000Z","last_app_login_at":null,"is_archived":0,"last_activated":null,"from_source":null,"delete_requested_at":null,"deleted_at":null,"is_erased":0,"created_at":"2026-06-09T05:33:39.000000Z","updated_at":"2026-06-09T05:33:39.000000Z","deleted_by":null,"interests":null,"address":{"iso":"AUS","region_code":"VIC","coordinates":{"latitude":null,"longitude":null},"street_address_1":"1 Example Street","street_address_2":null,"street_address_3":null,"city":"Melbourne","postcode":"3000","region":"VIC","country":"AU","latitude":null,"longitude":null},"added_at":"2026-06-09T05:33:39.000000Z"},"nice":{"rrn":"rrn:local:20101:user:xxxxxxxxxxxxxxxxxxxxxxxx","address":"1 Example Street\nMelbourne\nVictoria\nAustralia\n3000","address_oneline":"1 Example Street, Melbourne, Victoria, Australia, 3000","address.country":"Australia","address.country:raw":"AUS","address.city":"Melbourne","address.region":"Victoria","address.region:raw":"VIC","address.postcode":"3000","address.street_address_1":"1 Example Street","address.street_address_2":null,"address.street_address_3":null,"address.latitude":null,"address.longitude":null,"family_id":null,"has_family_members":"No","manages_family":false,"family_manager":"No","family_member":"No","is_family_member":false,"is_engaged":"No","is_engaged:raw":false,"last_engaged_at":null,"last_engaged_at:raw":null,"created_at":"Jun 9, 2026, 5:33 AM","created_at__date":"Jun 9, 2026","created_at__time":"5:33 AM","created_at__offset":" (+00:00 UTC)","created_at__offset_minutes":0,"created_at__dayofweek":"Tuesday","email_verified":"No","from_source":"","interests":null,"interests:value":null,"interests:array":null,"is_subscribed_transactional":"Yes","is_team_leader":"No","last_login_at":"Aug 10, 2026, 5:16 AM","last_login_at__date":"Aug 10, 2026","last_login_at__time":"5:16 AM","last_login_at__offset":" (+00:00 UTC)","last_login_at__offset_minutes":0,"last_login_at__dayofweek":"Monday","middle_name":"","picture_status":"N/A","picture_status:value":0,"picture_status:array":"N/A","shift_privacy":"Yes","updated_at":"Jun 9, 2026, 5:33 AM","updated_at__date":"Jun 9, 2026","updated_at__time":"5:33 AM","updated_at__offset":" (+00:00 UTC)","updated_at__offset_minutes":0,"updated_at__dayofweek":"Tuesday","first_name":"Jordan","last_name":"Avery","preferred_name":"","phone:qr_code_value":"au-297809703","phone":"(+61) 297809703","phone:raw":"+61297809703","phone:local_au":"0297809703","dob":"Jan 1, 1990","dob__dayofweek":"Monday","is_subscribed":"No","terms":"Yes","name":"Jordan Avery","age":36,"age_months":"36 years, 7 months","info":"Jordan Avery (jordan.avery@example.com)","preferred_first_name":"Jordan","delete_requested":false,"updated_hours":1583.176031565,"is_community_user":false,"timezone":"UTC"},"relations":{"user_checkpoint":{"object":{"id":3,"user_checkpoint_type_id":null,"name":"Default","label":"default","permissions":{"all":"1"},"actions":[],"is_inheritable":0,"sort_order":0,"deleted_at":null,"created_at":"2026-06-09T05:33:39.000000Z","updated_at":"2026-06-09T05:34:24.000000Z"},"nice":{"rrn":"rrn:local:20101:checkpoint:3","content_id":3,"account_name_path":"Example Organisation","is_foreign_account":false},"permissions":{"read":true,"update":true,"delete":false}},"user_type":{"object":{"id":2,"account_branding_id":null,"name":"Default","code":"default","profile_form_id":null,"training_ids":null,"registration_form_id":null,"shift_limit":0,"shift_max_time":null,"max_shift_length":0,"min_shift_length":0,"min_consecutive_rest_time_per_week":0,"max_work_days_per_week":0,"gap_between_shifts":0,"group_leader_attributes":null,"deleted_at":null,"created_at":"2026-06-09T05:33:39.000000Z","updated_at":"2026-06-09T05:33:39.000000Z","uuid":"0cdefc27-b599-4a15-a82f-18c11bb44803"},"nice":[],"permissions":{"read":true,"update":true,"delete":false}},"account":{"object":{"id":20101,"parent_id":1,"account_type_id":3,"path":"1/20101","name":"Example Organisation","config":{"active_settings":["general:locale","general:timezone","general:country","users:login","users:register","users:require_dob","event:shift_status_default","event:self_checkin","branding:name","branding:primary_color"]},"meta":[],"visibility_rules":[],"status":"approved","status_reason":null,"sort_order":0,"start_timestamp":null,"end_timestamp":null,"notes":null,"contact_firstname":null,"contact_lastname":null,"contact_email":null,"contact_phone":null,"support_manager_email":"billing@example.com","allow_deletion_request":1,"organization_type":null,"contract_start_date":"2026-06-09","contract_end_date":"2027-06-09","billing_contact_email":"billing@example.com","billing_support_email":"billing@example.com","is_enabled":1,"additional_billing_support_email":"billing@example.com","delete_requested_at":null,"is_archived":0,"trial_ends_at":null,"can_erase":0,"deleted_at":null,"is_erased":0,"created_at":"2026-06-09T05:33:32.000000Z","updated_at":"2026-06-09T07:08:01.000000Z"},"nice":{"rrn":"rrn:local:1:account:20101","address":"No Address","address_oneline":"No Address","account_type_id":3,"account_type_id:value":3,"account_type_id:array":3,"allow_deletion_request":"Yes","contact_firstname":"","contact_lastname":"","contact_phone:qr_code_value":"","contact_phone":"","contact_phone:raw":"","contract_end_date":"Jun 9, 2027","contract_end_date__dayofweek":"Wednesday","contract_start_date":"Jun 9, 2026","contract_start_date__dayofweek":"Tuesday","name":"Example Organisation","notes":"","organization_type":null,"organization_type:value":null,"organization_type:array":null,"status":"Approved","status:value":"approved","status:array":"approved","status_reason":"","created_at":"2026-06-09 05:33:32","url":"https://example.rosterfy.com/","branding_name":"Example Organisation","branding_subtitle":null,"branding_logo":null,"branding_logo_mono":null,"branding_logo_stacked":null,"branding_banner":null,"branding_favicon":null,"branding_description":null,"branding_primary_color":"#3131c7","branding_complimentary_color":null,"branding_secondary_color":"#38b6ff","register":false,"organisation_contact":" ","has_subaccount_approved_email_template":false,"has_subaccount_rejected_email_template":false,"parent_account_name":"Example Parent Organisation"},"permissions":{"read":true,"update":false,"delete":false}},"family":null,"family_user":null},"permissions":{"read":true,"update":false,"delete":false},"attributes":[]},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}],"first_page_url":"https://example.rosterfy.com/api/v2/account/role/{role}/user?per_page=5&_locale=en-US&page=1","from":1,"next_page_url":"https://example.rosterfy.com/api/v2/account/role/{role}/user?per_page=5&_locale=en-US&page=2","path":"https://example.rosterfy.com/api/v2/account/role/{role}/user","per_page":5,"prev_page_url":null,"to":5}]]},"id":"schema_309"},"schema_310":{"kind":"json-schema","data":{"type":"object","properties":{"user_id":{"type":"integer","description":"The person to give the role to.","examples":[23453473]}},"required":["user_id"]},"id":"schema_310"},"schema_311":{"kind":"json-schema","data":{"type":"object","properties":{},"examples":[{}]},"id":"schema_311"},"schema_312":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","examples":["User already exists in this role"]}},"examples":[{"message":"User already exists in this role"}]},"id":"schema_312"},"schema_313":{"kind":"json-schema","data":{"type":"object","properties":{"applyTo":{"type":"string","description":"Must be sent, with the value selected. This endpoint only ever adds the people named in selected; no other value changes what it does.","examples":[null]},"selected":{"type":"array","description":"The people to add, as a list of user ids. A person who cannot be given the role - because they belong to a different account, or already hold a role in this one - is skipped rather than reported.","items":{"type":"integer"},"examples":[[]]}},"required":["applyTo","selected"]},"id":"schema_313"},"schema_314":{"kind":"json-schema","data":{"type":"array","items":{"type":"object","properties":{"current_page":{"type":"integer","examples":[1]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"name":{"type":"string","examples":["suscipit laudantium iste"]},"sub_heading":{"type":["string","null"],"examples":[null]},"description":{"type":"string","examples":[""]},"content":{"type":"string","examples":["<p>Iste tempore autem saepe eligendi tempore rerum saepe. Doloremque consectetur sint earum corrupti officia omnis. Omnis iusto corporis et non ut.</p><p>Odio sed aliquam iure architecto optio ea. Quae sit occaecati quas quia. Praesentium ipsam nobis nesciunt nam.</p><p>Aut tempore eos perferendis aliquid suscipit ut qui dolorem. Consequatur voluptatibus cumque molestiae. Harum itaque qui ad ipsa tempora commodi earum.</p><p>Tenetur officiis sunt delectus. Minima voluptas eum debitis omnis rerum numquam unde ipsa. Ut asperiores velit quisquam et amet earum. Eligendi est debitis sit quos voluptatem. Atque aut quae officiis sint voluptatem.</p>"]},"blog_article_type_id":{"type":["string","null"],"examples":[null]},"author_id":{"type":"integer","examples":[23453598]},"thumbnail":{"type":"string","examples":["https://qa.rosterfy.com/static/img/testing/thumbnail_400_400.jpg"]},"wide_thumbnail":{"type":["string","null"],"examples":[null]},"banner_image":{"type":"string","examples":["https://qa.rosterfy.com/static/img/testing/banner_image_1200_300.jpeg"]},"token":{"type":"string","examples":["xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"]},"public":{"type":"integer","examples":[1]},"publish":{"type":"integer","examples":[1]},"promoted":{"type":"integer","examples":[0]},"created_at":{"type":"string","examples":["2026-06-09T05:36:26.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:26.000000Z"]}}},"nice":{"type":"object","properties":{"description":{"type":"string","examples":["Iste tempore autem saepe eligendi tempore rerum saepe. Doloremque consectetur sint earum corrupti of..."]},"read_at":{"type":"string","examples":["2026-07-29 01:25:31"]},"liked":{"type":"boolean","examples":[false]},"total_likes":{"type":"integer","examples":[0]}}},"relations":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}}},"examples":[[{"object":{"id":1,"name":"suscipit laudantium iste","sub_heading":null,"description":"","content":"<p>Iste tempore autem saepe eligendi tempore rerum saepe. Doloremque consectetur sint earum corrupti officia omnis. Omnis iusto corporis et non ut.</p><p>Odio sed aliquam iure architecto optio ea. Quae sit occaecati quas quia. Praesentium ipsam nobis nesciunt nam.</p><p>Aut tempore eos perferendis aliquid suscipit ut qui dolorem. Consequatur voluptatibus cumque molestiae. Harum itaque qui ad ipsa tempora commodi earum.</p><p>Tenetur officiis sunt delectus. Minima voluptas eum debitis omnis rerum numquam unde ipsa. Ut asperiores velit quisquam et amet earum. Eligendi est debitis sit quos voluptatem. Atque aut quae officiis sint voluptatem.</p>","blog_article_type_id":null,"author_id":23453598,"thumbnail":"https://qa.rosterfy.com/static/img/testing/thumbnail_400_400.jpg","wide_thumbnail":null,"banner_image":"https://qa.rosterfy.com/static/img/testing/banner_image_1200_300.jpeg","token":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","public":1,"publish":1,"promoted":0,"created_at":"2026-06-09T05:36:26.000000Z","updated_at":"2026-06-09T05:36:26.000000Z"},"nice":{"description":"Iste tempore autem saepe eligendi tempore rerum saepe. Doloremque consectetur sint earum corrupti of...","read_at":"2026-07-29 01:25:31","liked":false,"total_likes":0},"relations":[],"permissions":{"read":true,"update":true,"delete":true}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}]]},"first_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/blog/article?per_page=5&_locale=en-US&page=1"]},"from":{"type":"integer","examples":[1]},"next_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/blog/article?per_page=5&_locale=en-US&page=2"]},"path":{"type":"string","examples":["https://example.rosterfy.com/api/v2/blog/article"]},"per_page":{"type":"integer","examples":[5]},"prev_page_url":{"type":["string","null"],"examples":[null]},"to":{"type":"integer","examples":[5]}}},"examples":[[{"current_page":1,"data":[{"object":{"id":1,"name":"suscipit laudantium iste","sub_heading":null,"description":"","content":"<p>Iste tempore autem saepe eligendi tempore rerum saepe. Doloremque consectetur sint earum corrupti officia omnis. Omnis iusto corporis et non ut.</p><p>Odio sed aliquam iure architecto optio ea. Quae sit occaecati quas quia. Praesentium ipsam nobis nesciunt nam.</p><p>Aut tempore eos perferendis aliquid suscipit ut qui dolorem. Consequatur voluptatibus cumque molestiae. Harum itaque qui ad ipsa tempora commodi earum.</p><p>Tenetur officiis sunt delectus. Minima voluptas eum debitis omnis rerum numquam unde ipsa. Ut asperiores velit quisquam et amet earum. Eligendi est debitis sit quos voluptatem. Atque aut quae officiis sint voluptatem.</p>","blog_article_type_id":null,"author_id":23453598,"thumbnail":"https://qa.rosterfy.com/static/img/testing/thumbnail_400_400.jpg","wide_thumbnail":null,"banner_image":"https://qa.rosterfy.com/static/img/testing/banner_image_1200_300.jpeg","token":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","public":1,"publish":1,"promoted":0,"created_at":"2026-06-09T05:36:26.000000Z","updated_at":"2026-06-09T05:36:26.000000Z"},"nice":{"description":"Iste tempore autem saepe eligendi tempore rerum saepe. Doloremque consectetur sint earum corrupti of...","read_at":"2026-07-29 01:25:31","liked":false,"total_likes":0},"relations":[],"permissions":{"read":true,"update":true,"delete":true}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}],"first_page_url":"https://example.rosterfy.com/api/v2/blog/article?per_page=5&_locale=en-US&page=1","from":1,"next_page_url":"https://example.rosterfy.com/api/v2/blog/article?per_page=5&_locale=en-US&page=2","path":"https://example.rosterfy.com/api/v2/blog/article","per_page":5,"prev_page_url":null,"to":5}]]},"id":"schema_314"},"schema_315":{"kind":"json-schema","data":{"type":"object","properties":{"name":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The article title. Translatable: send a plain string to set it for the request locale, or an object keyed by locale such as {\"en-US\": \"Title\"}."},"children":[]}]}]}],"examples":["suscipit laudantium iste"]},"content":{"type":"string","description":"The article body as HTML. Translatable, as for name. HTML is sanitised on read, so scripts and unsafe attributes are stripped from responses.","examples":["<p>Iste tempore autem saepe eligendi tempore rerum saepe. Doloremque consectetur sint earum corrupti officia omnis. Omnis iusto corporis et non ut.</p><p>Odio sed aliquam iure architecto optio ea. Quae sit occaecati quas quia. Praesentium ipsam nobis nesciunt nam.</p><p>Aut tempore eos perferendis aliquid suscipit ut qui dolorem. Consequatur voluptatibus cumque molestiae. Harum itaque qui ad ipsa tempora commodi earum.</p><p>Tenetur officiis sunt delectus. Minima voluptas eum debitis omnis rerum numquam unde ipsa. Ut asperiores velit quisquam et amet earum. Eligendi est debitis sit quos voluptatem. Atque aut quae officiis sint voluptatem.</p>"]},"sub_heading":{"type":"string","description":"A secondary heading shown under the title. Translatable, as for name.","examples":[null]},"publish":{"type":"boolean","description":"Boolean. Whether the article appears in the portal News Articles section.","examples":[1]},"public":{"type":"boolean","description":"Boolean. Whether the article is reachable without logging in, via its token. Independent of publish.","examples":[1]},"promoted":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Boolean. Whether the article appears on the portal dashboard. Rejected if it would exceed the account's limit:max_promoted_news setting."},"children":[]}]}]}],"examples":[0]},"banner_image":{"type":"string","description":"URL of, or an upload for, the banner image shown at the top of the article. Recommended 1200x300 pixels.","examples":["https://qa.rosterfy.com/static/img/testing/banner_image_1200_300.jpeg"]},"thumbnail":{"type":"string","description":"URL of, or an upload for, the thumbnail image shown in the half-width article list. Recommended 300x300 pixels.","examples":["https://qa.rosterfy.com/static/img/testing/thumbnail_400_400.jpg"]},"wide_thumbnail":{"type":"string","description":"URL of, or an upload for, the thumbnail image shown in the full-width article list. Recommended 600x300 pixels.","examples":[null]},"description":{"type":"string","description":"A short summary of the article. Translatable, as for name. When empty, the nice.description in responses falls back to the first 100 characters of content.","examples":[""]},"blog_article_type_id":{"type":"integer","description":"The ID of the article type to categorise this article under.","examples":[1]}},"required":["name","content","publish","public"]},"id":"schema_315"},"schema_316":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"name":{"type":"string","examples":["suscipit laudantium iste"]},"sub_heading":{"type":["string","null"],"examples":[null]},"description":{"type":"string","examples":[""]},"content":{"type":"string","examples":["<p>Iste tempore autem saepe eligendi tempore rerum saepe. Doloremque consectetur sint earum corrupti officia omnis. Omnis iusto corporis et non ut.</p><p>Odio sed aliquam iure architecto optio ea. Quae sit occaecati quas quia. Praesentium ipsam nobis nesciunt nam.</p><p>Aut tempore eos perferendis aliquid suscipit ut qui dolorem. Consequatur voluptatibus cumque molestiae. Harum itaque qui ad ipsa tempora commodi earum.</p><p>Tenetur officiis sunt delectus. Minima voluptas eum debitis omnis rerum numquam unde ipsa. Ut asperiores velit quisquam et amet earum. Eligendi est debitis sit quos voluptatem. Atque aut quae officiis sint voluptatem.</p>"]},"blog_article_type_id":{"type":["string","null"],"examples":[null]},"author_id":{"type":"integer","examples":[23453598]},"thumbnail":{"type":"string","examples":["https://qa.rosterfy.com/static/img/testing/thumbnail_400_400.jpg"]},"wide_thumbnail":{"type":["string","null"],"examples":[null]},"banner_image":{"type":"string","examples":["https://qa.rosterfy.com/static/img/testing/banner_image_1200_300.jpeg"]},"token":{"type":"string","examples":["xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"]},"public":{"type":"integer","examples":[1]},"publish":{"type":"integer","examples":[1]},"promoted":{"type":"integer","examples":[0]},"created_at":{"type":"string","examples":["2026-06-09T05:36:26.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:26.000000Z"]}}},"nice":{"type":"object","properties":{"description":{"type":"string","examples":["Iste tempore autem saepe eligendi tempore rerum saepe. Doloremque consectetur sint earum corrupti of..."]},"read_at":{"type":"string","examples":["2026-07-29 01:25:31"]},"liked":{"type":"boolean","examples":[false]},"total_likes":{"type":"integer","examples":[0]}}},"relations":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}},"examples":[{"object":{"id":1,"name":"suscipit laudantium iste","sub_heading":null,"description":"","content":"<p>Iste tempore autem saepe eligendi tempore rerum saepe. Doloremque consectetur sint earum corrupti officia omnis. Omnis iusto corporis et non ut.</p><p>Odio sed aliquam iure architecto optio ea. Quae sit occaecati quas quia. Praesentium ipsam nobis nesciunt nam.</p><p>Aut tempore eos perferendis aliquid suscipit ut qui dolorem. Consequatur voluptatibus cumque molestiae. Harum itaque qui ad ipsa tempora commodi earum.</p><p>Tenetur officiis sunt delectus. Minima voluptas eum debitis omnis rerum numquam unde ipsa. Ut asperiores velit quisquam et amet earum. Eligendi est debitis sit quos voluptatem. Atque aut quae officiis sint voluptatem.</p>","blog_article_type_id":null,"author_id":23453598,"thumbnail":"https://qa.rosterfy.com/static/img/testing/thumbnail_400_400.jpg","wide_thumbnail":null,"banner_image":"https://qa.rosterfy.com/static/img/testing/banner_image_1200_300.jpeg","token":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","public":1,"publish":1,"promoted":0,"created_at":"2026-06-09T05:36:26.000000Z","updated_at":"2026-06-09T05:36:26.000000Z"},"nice":{"description":"Iste tempore autem saepe eligendi tempore rerum saepe. Doloremque consectetur sint earum corrupti of...","read_at":"2026-07-29 01:25:31","liked":false,"total_likes":0},"relations":[],"permissions":{"read":true,"update":true,"delete":true}}]},"id":"schema_316"},"schema_317":{"kind":"json-schema","data":{"type":"integer","examples":[1]},"id":"schema_317"},"schema_318":{"kind":"json-schema","data":{"type":"object","properties":{"name":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The article title. Translatable: send a plain string to set it for the request locale, or an object keyed by locale such as {\"en-US\": \"Title\"}."},"children":[]}]}]}],"examples":["suscipit laudantium iste"]},"sub_heading":{"type":"string","description":"A secondary heading shown under the title. Translatable, as for name.","examples":[null]},"description":{"type":"string","description":"A short summary of the article. Translatable, as for name. When empty, the nice.description in responses falls back to the first 100 characters of content.","examples":[""]},"content":{"type":"string","description":"The article body as HTML. Translatable, as for name. HTML is sanitised on read, so scripts and unsafe attributes are stripped from responses.","examples":["<p>Iste tempore autem saepe eligendi tempore rerum saepe. Doloremque consectetur sint earum corrupti officia omnis. Omnis iusto corporis et non ut.</p><p>Odio sed aliquam iure architecto optio ea. Quae sit occaecati quas quia. Praesentium ipsam nobis nesciunt nam.</p><p>Aut tempore eos perferendis aliquid suscipit ut qui dolorem. Consequatur voluptatibus cumque molestiae. Harum itaque qui ad ipsa tempora commodi earum.</p><p>Tenetur officiis sunt delectus. Minima voluptas eum debitis omnis rerum numquam unde ipsa. Ut asperiores velit quisquam et amet earum. Eligendi est debitis sit quos voluptatem. Atque aut quae officiis sint voluptatem.</p>"]},"thumbnail":{"type":"string","description":"URL of, or an upload for, the thumbnail image shown in the half-width article list. Recommended 300x300 pixels.","examples":["https://qa.rosterfy.com/static/img/testing/thumbnail_400_400.jpg"]},"wide_thumbnail":{"type":"string","description":"URL of, or an upload for, the thumbnail image shown in the full-width article list. Recommended 600x300 pixels.","examples":[null]},"banner_image":{"type":"string","description":"URL of, or an upload for, the banner image shown at the top of the article. Recommended 1200x300 pixels.","examples":["https://qa.rosterfy.com/static/img/testing/banner_image_1200_300.jpeg"]},"blog_article_type_id":{"type":"integer","description":"The ID of the article type to categorise this article under.","examples":[1]},"publish":{"type":"boolean","description":"Boolean. Whether the article appears in the portal News Articles section.","examples":[1]},"public":{"type":"boolean","description":"Boolean. Whether the article is reachable without logging in, via its token. Independent of publish.","examples":[1]},"promoted":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Boolean. Whether the article appears on the portal dashboard. Rejected if it would exceed the account's limit:max_promoted_news setting."},"children":[]}]}]}],"examples":[0]}}},"id":"schema_318"},"schema_319":{"kind":"json-schema","data":{"type":"array","items":{"type":"object","properties":{"current_page":{"type":"integer","examples":[1]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"name":{"type":"string","examples":["Paper Goods Machine Operator_EBMsffvoa9Ht"]},"short_description":{"type":["string","null"],"examples":[null]},"thumbnail_url":{"type":["string","null"],"examples":[null]},"account_id":{"type":"integer","examples":[20101]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-06-09T05:36:31.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:31.000000Z"]},"success_message":{"type":"string","examples":["Quia quo est et consequatur qui quis quibusdam."]},"is_archived":{"type":"integer","examples":[0]},"is_elective":{"type":"integer","examples":[0]},"estimated_complete_time":{"type":"integer","examples":[11]},"ttl":{"type":"integer","examples":[0]},"pass_score":{"type":"integer","examples":[0]},"is_library":{"type":"integer","examples":[0]},"publish":{"type":"integer","examples":[1]},"service":{"type":"string","examples":["online"]},"external_id":{"type":["string","null"],"examples":[null]},"meta":{"type":"array","examples":[[]]},"token":{"type":"string","examples":["xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"]},"sort_order":{"type":"integer","examples":[0]},"certificate_id":{"type":["string","null"],"examples":[null]},"form_id":{"type":["string","null"],"examples":[null]},"type_id":{"type":["string","null"],"examples":[null]},"is_inheritable":{"type":"integer","examples":[0]}}},"nice":{"type":"object","properties":{"publish":{"type":"string","examples":["Yes"]},"account_id":{"type":"integer","examples":[20101]},"account_url":{"type":"string","examples":["https://sub.rosterfy2.localhost.com/"]},"external":{"type":"boolean","examples":[false]},"has_certificate":{"type":"boolean","examples":[false]},"account_name_path":{"type":"string","examples":["Rosterfy Subaccount"]},"is_foreign_account":{"type":"boolean","examples":[false]},"acts_as_native":{"type":"boolean","examples":[false]},"number_of_steps":{"type":"integer","examples":[3]},"number_of_questions":{"type":"integer","examples":[0]}}},"relations":{"type":"object","properties":{"account":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[20101]},"parent_id":{"type":"integer","examples":[1]},"account_type_id":{"type":"integer","examples":[3]},"path":{"type":"string","examples":["1/20101"]},"name":{"type":"string","examples":["Rosterfy Subaccount"]},"config":{"type":"object","properties":{"active_settings":{"type":"array","items":{"type":"string"},"examples":[["general:available_locales","general:locale","general:timezone","general:country","general:distance_unit","general:approved_countries","general:start_day_of_week","general:location","users:photo_width","users:photo_height","users:login","users:login_session_length","users:login_social","users:login_recaptcha","users:register","users:require_dob","users:minimum_age","users:minimum_age_by_date","users:allow_availability_form_field","event:advanced_scheduling","event:shift_max_time","event:gap_between_shifts","event:min_shift_length","event:max_shift_length","event:min_shift_apps_per_user","event:max_shift_apps_per_user","event:shift_status_default","event:shift_confirmed_status_default","event:shift_rejected_status_default","event:shift_can_withdraw_default","event:shift_can_withdraw_limit","event:shift_can_confirm_limit","event:shift_checked_in_status_default","event:shift_application_form_id_default","event:shift_checkin_form_id_default","event:shift_attended_form_id_default","event:shift_checkout_form_id_default","event:shift_feedback_form_id_default","event:self_checkin","event:self_checkin_open","event:self_checkin_close","event:self_checkout_close","event:checkin_visible_attributes","event:shift_show_demand","training:id","email:from_name","email:reply_to","email:forgot_password_template_id","email:email_verification_template_id","email:user_lockout_template_id","email:user_invitation_email_template_id","email:contact_us_email_template_id","email:admin_invitation_email_template_id","email:banner","branding:name","branding:subtitle","branding:address","branding:logo","branding:logo_mono","branding:background_image","branding:banner_image","branding:favicon","branding:primary_color","branding:secondary_color","branding:custom_css","advanced:default_dashboard","portal:visible_stats"]]}}},"meta":{"type":"array","examples":[[]]},"visibility_rules":{"type":"array","examples":[[]]},"status":{"type":"string","examples":["approved"]},"status_reason":{"type":["string","null"],"examples":[null]},"sort_order":{"type":"integer","examples":[0]},"start_timestamp":{"type":["string","null"],"examples":[null]},"end_timestamp":{"type":["string","null"],"examples":[null]},"notes":{"type":["string","null"],"examples":[null]},"contact_firstname":{"type":["string","null"],"examples":[null]},"contact_lastname":{"type":["string","null"],"examples":[null]},"contact_email":{"type":["string","null"],"examples":[null]},"contact_phone":{"type":["string","null"],"examples":[null]},"support_manager_email":{"type":"string","examples":["support_manager@rosterfy.com"]},"allow_deletion_request":{"type":"integer","examples":[1]},"organization_type":{"type":["string","null"],"examples":[null]},"contract_start_date":{"type":"string","examples":["2026-06-09"]},"contract_end_date":{"type":"string","examples":["2027-06-09"]},"billing_contact_email":{"type":"string","examples":["billing_contact@rosterfy.com"]},"billing_support_email":{"type":"string","examples":["billing_support@rosterfy.com"]},"is_enabled":{"type":"integer","examples":[1]},"additional_billing_support_email":{"type":"string","examples":["additional_billing_contact@rosterfy.com"]},"delete_requested_at":{"type":["string","null"],"examples":[null]},"is_archived":{"type":"integer","examples":[0]},"trial_ends_at":{"type":["string","null"],"examples":[null]},"can_erase":{"type":"integer","examples":[0]},"deleted_at":{"type":["string","null"],"examples":[null]},"is_erased":{"type":"integer","examples":[0]},"created_at":{"type":"string","examples":["2026-06-09T05:33:32.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T07:08:01.000000Z"]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:1:account:20101"]},"address":{"type":"string","examples":["No Address"]},"address_oneline":{"type":"string","examples":["No Address"]},"account_type_id":{"type":"string","examples":["Enterprise"]},"account_type_id:value":{"type":"integer","examples":[3]},"account_type_id:array":{"type":"string","examples":["Enterprise"]},"allow_deletion_request":{"type":"string","examples":["Yes"]},"contact_firstname":{"type":"string","examples":[""]},"contact_lastname":{"type":"string","examples":[""]},"contact_phone:qr_code_value":{"type":"string","examples":[""]},"contact_phone":{"type":"string","examples":[""]},"contact_phone:raw":{"type":"string","examples":[""]},"contract_end_date":{"type":"string","examples":["Jun 9, 2027"]},"contract_end_date__dayofweek":{"type":"string","examples":["Wednesday"]},"contract_start_date":{"type":"string","examples":["Jun 9, 2026"]},"contract_start_date__dayofweek":{"type":"string","examples":["Tuesday"]},"name":{"type":"string","examples":["Rosterfy Subaccount"]},"notes":{"type":"string","examples":[""]},"organization_type":{"type":["string","null"],"examples":[null]},"organization_type:value":{"type":["string","null"],"examples":[null]},"organization_type:array":{"type":["string","null"],"examples":[null]},"status":{"type":"string","examples":["Approved"]},"status:value":{"type":"string","examples":["approved"]},"status:array":{"type":"string","examples":["approved"]},"status_reason":{"type":"string","examples":[""]},"created_at":{"type":"string","examples":["2026-06-09 05:33:32"]},"url":{"type":"string","examples":["https://sub.rosterfy2.localhost.com/"]},"branding_name":{"type":"string","examples":["Rosterfy"]},"branding_subtitle":{"type":["string","null"],"examples":[null]},"branding_logo":{"type":["string","null"],"examples":[null]},"branding_logo_mono":{"type":["string","null"],"examples":[null]},"branding_logo_stacked":{"type":["string","null"],"examples":[null]},"branding_banner":{"type":["string","null"],"examples":[null]},"branding_description":{"type":["string","null"],"examples":[null]},"branding_primary_color":{"type":"string","examples":["#3131c7"]},"branding_complimentary_color":{"type":["string","null"],"examples":[null]},"branding_secondary_color":{"type":"string","examples":["#38b6ff"]},"register":{"type":"boolean","examples":[false]},"organisation_contact":{"type":"string","examples":[" "]},"has_subaccount_approved_email_template":{"type":"boolean","examples":[false]},"has_subaccount_rejected_email_template":{"type":"boolean","examples":[false]},"parent_account_name":{"type":"string","examples":["Rosterfy2"]}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[false]},"delete":{"type":"boolean","examples":[false]}}}}},"certificate":{"type":["string","null"],"examples":[null]}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}}},"examples":[[{"object":{"id":1,"name":"Paper Goods Machine Operator_EBMsffvoa9Ht","short_description":null,"thumbnail_url":null,"account_id":20101,"deleted_at":null,"created_at":"2026-06-09T05:36:31.000000Z","updated_at":"2026-06-09T05:36:31.000000Z","success_message":"Quia quo est et consequatur qui quis quibusdam.","is_archived":0,"is_elective":0,"estimated_complete_time":11,"ttl":0,"pass_score":0,"is_library":0,"publish":1,"service":"online","external_id":null,"meta":[],"token":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","sort_order":0,"certificate_id":null,"form_id":null,"type_id":null,"is_inheritable":0},"nice":{"publish":"Yes","account_id":20101,"account_url":"https://sub.rosterfy2.localhost.com/","external":false,"has_certificate":false,"account_name_path":"Rosterfy Subaccount","is_foreign_account":false,"acts_as_native":false,"number_of_steps":3,"number_of_questions":0},"relations":{"account":{"object":{"id":20101,"parent_id":1,"account_type_id":3,"path":"1/20101","name":"Rosterfy Subaccount","config":{"active_settings":["general:available_locales","general:locale","general:timezone","general:country","general:distance_unit","general:approved_countries","general:start_day_of_week","general:location","users:photo_width","users:photo_height","users:login","users:login_session_length","users:login_social","users:login_recaptcha","users:register","users:require_dob","users:minimum_age","users:minimum_age_by_date","users:allow_availability_form_field","event:advanced_scheduling","event:shift_max_time","event:gap_between_shifts","event:min_shift_length","event:max_shift_length","event:min_shift_apps_per_user","event:max_shift_apps_per_user","event:shift_status_default","event:shift_confirmed_status_default","event:shift_rejected_status_default","event:shift_can_withdraw_default","event:shift_can_withdraw_limit","event:shift_can_confirm_limit","event:shift_checked_in_status_default","event:shift_application_form_id_default","event:shift_checkin_form_id_default","event:shift_attended_form_id_default","event:shift_checkout_form_id_default","event:shift_feedback_form_id_default","event:self_checkin","event:self_checkin_open","event:self_checkin_close","event:self_checkout_close","event:checkin_visible_attributes","event:shift_show_demand","training:id","email:from_name","email:reply_to","email:forgot_password_template_id","email:email_verification_template_id","email:user_lockout_template_id","email:user_invitation_email_template_id","email:contact_us_email_template_id","email:admin_invitation_email_template_id","email:banner","branding:name","branding:subtitle","branding:address","branding:logo","branding:logo_mono","branding:background_image","branding:banner_image","branding:favicon","branding:primary_color","branding:secondary_color","branding:custom_css","advanced:default_dashboard","portal:visible_stats"]},"meta":[],"visibility_rules":[],"status":"approved","status_reason":null,"sort_order":0,"start_timestamp":null,"end_timestamp":null,"notes":null,"contact_firstname":null,"contact_lastname":null,"contact_email":null,"contact_phone":null,"support_manager_email":"support_manager@rosterfy.com","allow_deletion_request":1,"organization_type":null,"contract_start_date":"2026-06-09","contract_end_date":"2027-06-09","billing_contact_email":"billing_contact@rosterfy.com","billing_support_email":"billing_support@rosterfy.com","is_enabled":1,"additional_billing_support_email":"additional_billing_contact@rosterfy.com","delete_requested_at":null,"is_archived":0,"trial_ends_at":null,"can_erase":0,"deleted_at":null,"is_erased":0,"created_at":"2026-06-09T05:33:32.000000Z","updated_at":"2026-06-09T07:08:01.000000Z"},"nice":{"rrn":"rrn:local:1:account:20101","address":"No Address","address_oneline":"No Address","account_type_id":"Enterprise","account_type_id:value":3,"account_type_id:array":"Enterprise","allow_deletion_request":"Yes","contact_firstname":"","contact_lastname":"","contact_phone:qr_code_value":"","contact_phone":"","contact_phone:raw":"","contract_end_date":"Jun 9, 2027","contract_end_date__dayofweek":"Wednesday","contract_start_date":"Jun 9, 2026","contract_start_date__dayofweek":"Tuesday","name":"Rosterfy Subaccount","notes":"","organization_type":null,"organization_type:value":null,"organization_type:array":null,"status":"Approved","status:value":"approved","status:array":"approved","status_reason":"","created_at":"2026-06-09 05:33:32","url":"https://sub.rosterfy2.localhost.com/","branding_name":"Rosterfy","branding_subtitle":null,"branding_logo":null,"branding_logo_mono":null,"branding_logo_stacked":null,"branding_banner":null,"branding_description":null,"branding_primary_color":"#3131c7","branding_complimentary_color":null,"branding_secondary_color":"#38b6ff","register":false,"organisation_contact":" ","has_subaccount_approved_email_template":false,"has_subaccount_rejected_email_template":false,"parent_account_name":"Rosterfy2"},"permissions":{"read":true,"update":false,"delete":false}},"certificate":null},"permissions":{"read":true,"update":true,"delete":true}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}]]},"first_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/training?per_page=5&_locale=en-US&page=1"]},"from":{"type":"integer","examples":[1]},"next_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/training?per_page=5&_locale=en-US&page=2"]},"path":{"type":"string","examples":["https://example.rosterfy.com/api/v2/training"]},"per_page":{"type":"integer","examples":[5]},"prev_page_url":{"type":["string","null"],"examples":[null]},"to":{"type":"integer","examples":[5]}}},"examples":[[{"current_page":1,"data":[{"object":{"id":1,"name":"Paper Goods Machine Operator_EBMsffvoa9Ht","short_description":null,"thumbnail_url":null,"account_id":20101,"deleted_at":null,"created_at":"2026-06-09T05:36:31.000000Z","updated_at":"2026-06-09T05:36:31.000000Z","success_message":"Quia quo est et consequatur qui quis quibusdam.","is_archived":0,"is_elective":0,"estimated_complete_time":11,"ttl":0,"pass_score":0,"is_library":0,"publish":1,"service":"online","external_id":null,"meta":[],"token":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","sort_order":0,"certificate_id":null,"form_id":null,"type_id":null,"is_inheritable":0},"nice":{"publish":"Yes","account_id":20101,"account_url":"https://sub.rosterfy2.localhost.com/","external":false,"has_certificate":false,"account_name_path":"Rosterfy Subaccount","is_foreign_account":false,"acts_as_native":false,"number_of_steps":3,"number_of_questions":0},"relations":{"account":{"object":{"id":20101,"parent_id":1,"account_type_id":3,"path":"1/20101","name":"Rosterfy Subaccount","config":{"active_settings":["general:available_locales","general:locale","general:timezone","general:country","general:distance_unit","general:approved_countries","general:start_day_of_week","general:location","users:photo_width","users:photo_height","users:login","users:login_session_length","users:login_social","users:login_recaptcha","users:register","users:require_dob","users:minimum_age","users:minimum_age_by_date","users:allow_availability_form_field","event:advanced_scheduling","event:shift_max_time","event:gap_between_shifts","event:min_shift_length","event:max_shift_length","event:min_shift_apps_per_user","event:max_shift_apps_per_user","event:shift_status_default","event:shift_confirmed_status_default","event:shift_rejected_status_default","event:shift_can_withdraw_default","event:shift_can_withdraw_limit","event:shift_can_confirm_limit","event:shift_checked_in_status_default","event:shift_application_form_id_default","event:shift_checkin_form_id_default","event:shift_attended_form_id_default","event:shift_checkout_form_id_default","event:shift_feedback_form_id_default","event:self_checkin","event:self_checkin_open","event:self_checkin_close","event:self_checkout_close","event:checkin_visible_attributes","event:shift_show_demand","training:id","email:from_name","email:reply_to","email:forgot_password_template_id","email:email_verification_template_id","email:user_lockout_template_id","email:user_invitation_email_template_id","email:contact_us_email_template_id","email:admin_invitation_email_template_id","email:banner","branding:name","branding:subtitle","branding:address","branding:logo","branding:logo_mono","branding:background_image","branding:banner_image","branding:favicon","branding:primary_color","branding:secondary_color","branding:custom_css","advanced:default_dashboard","portal:visible_stats"]},"meta":[],"visibility_rules":[],"status":"approved","status_reason":null,"sort_order":0,"start_timestamp":null,"end_timestamp":null,"notes":null,"contact_firstname":null,"contact_lastname":null,"contact_email":null,"contact_phone":null,"support_manager_email":"support_manager@rosterfy.com","allow_deletion_request":1,"organization_type":null,"contract_start_date":"2026-06-09","contract_end_date":"2027-06-09","billing_contact_email":"billing_contact@rosterfy.com","billing_support_email":"billing_support@rosterfy.com","is_enabled":1,"additional_billing_support_email":"additional_billing_contact@rosterfy.com","delete_requested_at":null,"is_archived":0,"trial_ends_at":null,"can_erase":0,"deleted_at":null,"is_erased":0,"created_at":"2026-06-09T05:33:32.000000Z","updated_at":"2026-06-09T07:08:01.000000Z"},"nice":{"rrn":"rrn:local:1:account:20101","address":"No Address","address_oneline":"No Address","account_type_id":"Enterprise","account_type_id:value":3,"account_type_id:array":"Enterprise","allow_deletion_request":"Yes","contact_firstname":"","contact_lastname":"","contact_phone:qr_code_value":"","contact_phone":"","contact_phone:raw":"","contract_end_date":"Jun 9, 2027","contract_end_date__dayofweek":"Wednesday","contract_start_date":"Jun 9, 2026","contract_start_date__dayofweek":"Tuesday","name":"Rosterfy Subaccount","notes":"","organization_type":null,"organization_type:value":null,"organization_type:array":null,"status":"Approved","status:value":"approved","status:array":"approved","status_reason":"","created_at":"2026-06-09 05:33:32","url":"https://sub.rosterfy2.localhost.com/","branding_name":"Rosterfy","branding_subtitle":null,"branding_logo":null,"branding_logo_mono":null,"branding_logo_stacked":null,"branding_banner":null,"branding_description":null,"branding_primary_color":"#3131c7","branding_complimentary_color":null,"branding_secondary_color":"#38b6ff","register":false,"organisation_contact":" ","has_subaccount_approved_email_template":false,"has_subaccount_rejected_email_template":false,"parent_account_name":"Rosterfy2"},"permissions":{"read":true,"update":false,"delete":false}},"certificate":null},"permissions":{"read":true,"update":true,"delete":true}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}],"first_page_url":"https://example.rosterfy.com/api/v2/training?per_page=5&_locale=en-US&page=1","from":1,"next_page_url":"https://example.rosterfy.com/api/v2/training?per_page=5&_locale=en-US&page=2","path":"https://example.rosterfy.com/api/v2/training","per_page":5,"prev_page_url":null,"to":5}]]},"id":"schema_319"},"schema_320":{"kind":"json-schema","data":{"type":"object","properties":{"success_message":{"type":"string","description":"The end of course message, shown when a user finishes the module. HTML, maximum 64,000 characters.","examples":["Quia quo est et consequatur qui quis quibusdam."]},"name":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name of the module. Maximum 255 characters. Translatable: send a plain string to set it for the request locale, or an object keyed by locale such as {\"en-US\": \"Induction\"}."},"children":[]}]}]}],"examples":["Paper Goods Machine Operator_EBMsffvoa9Ht"]},"estimated_complete_time":{"type":"integer","description":"How long the module is expected to take, in minutes.","examples":[11]},"publish":{"type":"boolean","description":"Whether the module is published. Until it is, the module is not visible in the portal.","examples":[1]},"is_archived":{"type":"boolean","description":"Whether the module is archived. The mass-archive endpoint sets this field in bulk.","examples":[0]},"is_elective":{"type":"boolean","description":"Whether any user who can access training may complete this module.","examples":[0]},"is_inheritable":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether accounts below the owning account may use this module. Reflected in the response as nice.acts_as_native."},"children":[]}]}]}],"examples":[0]},"type_id":{"type":"integer","description":"The ID of the training type to categorise this module under. Used for reporting and filtering, and optional.","examples":[1]},"service":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The training provider. One of online, scorm, scorm_upload or bespoke for modules Rosterfy hosts, or the code of an external provider. A module whose service is not one of the four local values reads as external, and the update endpoint ignores this field for those modules."},"children":[]}]}]}],"examples":["online"]},"external_id":{"type":"string","description":"The ID of the module in the external training provider. Recorded when the module is synced from that provider, and sent back to it on assignment and completion.","examples":[null]},"meta":{"type":"object","description":"Provider and behaviour options for the module. The documented subkeys follow. On create this object is stored as sent; on update it is merged into the stored object, so omitted subkeys keep their current values.","properties":{"onetime":{"type":"boolean","description":"Whether a user is blocked from repeating the module if they do not pass on the first attempt.","examples":[true]},"score":{"type":"boolean","description":"Whether a score is recorded. The user always moves to the next step when there is a question, and the total correct answers make up the score.","examples":[true]},"inform_answer":{"type":"boolean","description":"Whether the user is told if their answer was correct.","examples":[true]},"show_correct":{"type":"boolean","description":"Whether the user is shown the correct answers.","examples":[true]},"inform_score":{"type":"boolean","description":"Whether the user is shown the percentage required to pass and their own score at the end.","examples":[true]},"template_id":{"type":"integer","description":"The ID of the email template to send when a user finishes the module.","examples":[1]},"code":{"type":"string","description":"The course code the module has in the external provider. Set when the module is synced from that provider.","examples":[null]},"original_id":{"type":"string","description":"The original module ID in the external provider. Set when the module is synced from that provider.","examples":[null]},"source":{"type":"string","description":"The name of the external provider the module was synced from.","examples":[null]},"height":{"type":"integer","description":"The height of the SCORM frame in the portal, in pixels. Must be under 5000. Defaults to 600.","examples":[1]},"suspend":{"type":"boolean","description":"Whether the user is forced to restart the SCORM module if they return after starting it.","examples":[true]},"redirect_url":{"type":"string","description":"The URL the user is redirected to from the portal to take the training. Required when service is bespoke.","examples":[null]},"entrypoint":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The file the SCORM package starts at, usually index.html or story.html. Required when service is scorm or scorm_upload."},"children":[]}]}]}],"examples":[null]},"complete":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The status the SCORM file emits to tell Rosterfy the training is complete, usually complete or passed. Your SCORM provider will tell you this status. Required when service is scorm or scorm_upload."},"children":[]}]}]}],"examples":[null]}},"examples":[[]]},"ttl":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How long a completion stays valid, in seconds. A user is required to retake the module once it lapses, and re-completing resets the expiry. Only applied when greater than 0, and forced to 0 when can_expire is sent as false."},"children":[]}]}]}],"examples":[0]},"is_library":{"type":"boolean","description":"Stored, but read by nothing in the platform.","examples":[0]},"form_id":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the form a user completes before starting the module without a Rosterfy account. Setting it is also what makes the module readable unauthenticated - see the read endpoint. Cleared when anonymous_enable is sent as false."},"children":[]}]}]}],"examples":[1]},"certificate_id":{"type":"integer","description":"The ID of the certificate to award when the module is completed successfully.","examples":[1]},"pass_score":{"type":"integer","description":"The percentage a user must reach to be marked as passed, from 0 to 100. Applies when meta.score is true.","examples":[0]},"sort_order":{"type":"integer","description":"The position of the module where listings are ordered by sort order.","examples":[0]},"scorm_upload":{"type":"string","description":"URL of an uploaded SCORM zip, up to 100MB, which Rosterfy unzips and stores. Only acted on by the update endpoint; on create the field is accepted and ignored.","examples":[null]},"short_description":{"type":"string","description":"A short summary of the module. Not validated by the server; anything the column accepts is stored.","examples":[null]},"thumbnail_url":{"type":"string","description":"URL of, or an upload for, the module thumbnail. Recommended 245x150 pixels. Not validated by the server.","examples":[null]},"can_expire":{"type":"boolean","description":"Whether completions of this module expire. Not stored; sending it as false is what sets ttl to 0.","examples":[true]},"anonymous_enable":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether the module may be completed by someone without a Rosterfy account. Not stored; sending it as false is what clears form_id and meta.template_id."},"children":[]}]}]}],"examples":[true]}},"required":["success_message","name"]},"id":"schema_320"},"schema_321":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"name":{"type":"string","examples":["Paper Goods Machine Operator_EBMsffvoa9Ht"]},"short_description":{"type":["string","null"],"examples":[null]},"thumbnail_url":{"type":["string","null"],"examples":[null]},"account_id":{"type":"integer","examples":[20101]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-06-09T05:36:31.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:31.000000Z"]},"success_message":{"type":"string","examples":["Quia quo est et consequatur qui quis quibusdam."]},"is_archived":{"type":"integer","examples":[0]},"is_elective":{"type":"integer","examples":[0]},"estimated_complete_time":{"type":"integer","examples":[11]},"ttl":{"type":"integer","examples":[0]},"pass_score":{"type":"integer","examples":[0]},"is_library":{"type":"integer","examples":[0]},"publish":{"type":"integer","examples":[1]},"service":{"type":"string","examples":["online"]},"external_id":{"type":["string","null"],"examples":[null]},"meta":{"type":"array","examples":[[]]},"token":{"type":"string","examples":["xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"]},"sort_order":{"type":"integer","examples":[0]},"certificate_id":{"type":["string","null"],"examples":[null]},"form_id":{"type":["string","null"],"examples":[null]},"type_id":{"type":["string","null"],"examples":[null]},"is_inheritable":{"type":"integer","examples":[0]}}},"nice":{"type":"object","properties":{"publish":{"type":"string","examples":["Yes"]},"account_id":{"type":"integer","examples":[20101]},"account_url":{"type":"string","examples":["https://sub.rosterfy2.localhost.com/"]},"external":{"type":"boolean","examples":[false]},"has_certificate":{"type":"boolean","examples":[false]},"account_name_path":{"type":"string","examples":["Rosterfy Subaccount"]},"is_foreign_account":{"type":"boolean","examples":[false]},"acts_as_native":{"type":"boolean","examples":[false]},"number_of_steps":{"type":"integer","examples":[3]},"number_of_questions":{"type":"integer","examples":[0]}}},"relations":{"type":"object","properties":{"account":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[20101]},"parent_id":{"type":"integer","examples":[1]},"account_type_id":{"type":"integer","examples":[3]},"path":{"type":"string","examples":["1/20101"]},"name":{"type":"string","examples":["Rosterfy Subaccount"]},"config":{"type":"object","properties":{"active_settings":{"type":"array","items":{"type":"string"},"examples":[["general:available_locales","general:locale","general:timezone","general:country","general:distance_unit","general:approved_countries","general:start_day_of_week","general:location","users:photo_width","users:photo_height","users:login","users:login_session_length","users:login_social","users:login_recaptcha","users:register","users:require_dob","users:minimum_age","users:minimum_age_by_date","users:allow_availability_form_field","event:advanced_scheduling","event:shift_max_time","event:gap_between_shifts","event:min_shift_length","event:max_shift_length","event:min_shift_apps_per_user","event:max_shift_apps_per_user","event:shift_status_default","event:shift_confirmed_status_default","event:shift_rejected_status_default","event:shift_can_withdraw_default","event:shift_can_withdraw_limit","event:shift_can_confirm_limit","event:shift_checked_in_status_default","event:shift_application_form_id_default","event:shift_checkin_form_id_default","event:shift_attended_form_id_default","event:shift_checkout_form_id_default","event:shift_feedback_form_id_default","event:self_checkin","event:self_checkin_open","event:self_checkin_close","event:self_checkout_close","event:checkin_visible_attributes","event:shift_show_demand","training:id","email:from_name","email:reply_to","email:forgot_password_template_id","email:email_verification_template_id","email:user_lockout_template_id","email:user_invitation_email_template_id","email:contact_us_email_template_id","email:admin_invitation_email_template_id","email:banner","branding:name","branding:subtitle","branding:address","branding:logo","branding:logo_mono","branding:background_image","branding:banner_image","branding:favicon","branding:primary_color","branding:secondary_color","branding:custom_css","advanced:default_dashboard","portal:visible_stats"]]}}},"meta":{"type":"array","examples":[[]]},"visibility_rules":{"type":"array","examples":[[]]},"status":{"type":"string","examples":["approved"]},"status_reason":{"type":["string","null"],"examples":[null]},"sort_order":{"type":"integer","examples":[0]},"start_timestamp":{"type":["string","null"],"examples":[null]},"end_timestamp":{"type":["string","null"],"examples":[null]},"notes":{"type":["string","null"],"examples":[null]},"contact_firstname":{"type":["string","null"],"examples":[null]},"contact_lastname":{"type":["string","null"],"examples":[null]},"contact_email":{"type":["string","null"],"examples":[null]},"contact_phone":{"type":["string","null"],"examples":[null]},"support_manager_email":{"type":"string","examples":["support_manager@rosterfy.com"]},"allow_deletion_request":{"type":"integer","examples":[1]},"organization_type":{"type":["string","null"],"examples":[null]},"contract_start_date":{"type":"string","examples":["2026-06-09"]},"contract_end_date":{"type":"string","examples":["2027-06-09"]},"billing_contact_email":{"type":"string","examples":["billing_contact@rosterfy.com"]},"billing_support_email":{"type":"string","examples":["billing_support@rosterfy.com"]},"is_enabled":{"type":"integer","examples":[1]},"additional_billing_support_email":{"type":"string","examples":["additional_billing_contact@rosterfy.com"]},"delete_requested_at":{"type":["string","null"],"examples":[null]},"is_archived":{"type":"integer","examples":[0]},"trial_ends_at":{"type":["string","null"],"examples":[null]},"can_erase":{"type":"integer","examples":[0]},"deleted_at":{"type":["string","null"],"examples":[null]},"is_erased":{"type":"integer","examples":[0]},"created_at":{"type":"string","examples":["2026-06-09T05:33:32.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T07:08:01.000000Z"]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:1:account:20101"]},"address":{"type":"string","examples":["No Address"]},"address_oneline":{"type":"string","examples":["No Address"]},"account_type_id":{"type":"string","examples":["Enterprise"]},"account_type_id:value":{"type":"integer","examples":[3]},"account_type_id:array":{"type":"string","examples":["Enterprise"]},"allow_deletion_request":{"type":"string","examples":["Yes"]},"contact_firstname":{"type":"string","examples":[""]},"contact_lastname":{"type":"string","examples":[""]},"contact_phone:qr_code_value":{"type":"string","examples":[""]},"contact_phone":{"type":"string","examples":[""]},"contact_phone:raw":{"type":"string","examples":[""]},"contract_end_date":{"type":"string","examples":["Jun 9, 2027"]},"contract_end_date__dayofweek":{"type":"string","examples":["Wednesday"]},"contract_start_date":{"type":"string","examples":["Jun 9, 2026"]},"contract_start_date__dayofweek":{"type":"string","examples":["Tuesday"]},"name":{"type":"string","examples":["Rosterfy Subaccount"]},"notes":{"type":"string","examples":[""]},"organization_type":{"type":["string","null"],"examples":[null]},"organization_type:value":{"type":["string","null"],"examples":[null]},"organization_type:array":{"type":["string","null"],"examples":[null]},"status":{"type":"string","examples":["Approved"]},"status:value":{"type":"string","examples":["approved"]},"status:array":{"type":"string","examples":["approved"]},"status_reason":{"type":"string","examples":[""]},"created_at":{"type":"string","examples":["2026-06-09 05:33:32"]},"url":{"type":"string","examples":["https://sub.rosterfy2.localhost.com/"]},"branding_name":{"type":"string","examples":["Rosterfy"]},"branding_subtitle":{"type":["string","null"],"examples":[null]},"branding_logo":{"type":["string","null"],"examples":[null]},"branding_logo_mono":{"type":["string","null"],"examples":[null]},"branding_logo_stacked":{"type":["string","null"],"examples":[null]},"branding_banner":{"type":["string","null"],"examples":[null]},"branding_description":{"type":["string","null"],"examples":[null]},"branding_primary_color":{"type":"string","examples":["#3131c7"]},"branding_complimentary_color":{"type":["string","null"],"examples":[null]},"branding_secondary_color":{"type":"string","examples":["#38b6ff"]},"register":{"type":"boolean","examples":[false]},"organisation_contact":{"type":"string","examples":[" "]},"has_subaccount_approved_email_template":{"type":"boolean","examples":[false]},"has_subaccount_rejected_email_template":{"type":"boolean","examples":[false]},"parent_account_name":{"type":"string","examples":["Rosterfy2"]}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[false]},"delete":{"type":"boolean","examples":[false]}}}}},"certificate":{"type":["string","null"],"examples":[null]}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}},"examples":[{"object":{"id":1,"name":"Paper Goods Machine Operator_EBMsffvoa9Ht","short_description":null,"thumbnail_url":null,"account_id":20101,"deleted_at":null,"created_at":"2026-06-09T05:36:31.000000Z","updated_at":"2026-06-09T05:36:31.000000Z","success_message":"Quia quo est et consequatur qui quis quibusdam.","is_archived":0,"is_elective":0,"estimated_complete_time":11,"ttl":0,"pass_score":0,"is_library":0,"publish":1,"service":"online","external_id":null,"meta":[],"token":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","sort_order":0,"certificate_id":null,"form_id":null,"type_id":null,"is_inheritable":0},"nice":{"publish":"Yes","account_id":20101,"account_url":"https://sub.rosterfy2.localhost.com/","external":false,"has_certificate":false,"account_name_path":"Rosterfy Subaccount","is_foreign_account":false,"acts_as_native":false,"number_of_steps":3,"number_of_questions":0},"relations":{"account":{"object":{"id":20101,"parent_id":1,"account_type_id":3,"path":"1/20101","name":"Rosterfy Subaccount","config":{"active_settings":["general:available_locales","general:locale","general:timezone","general:country","general:distance_unit","general:approved_countries","general:start_day_of_week","general:location","users:photo_width","users:photo_height","users:login","users:login_session_length","users:login_social","users:login_recaptcha","users:register","users:require_dob","users:minimum_age","users:minimum_age_by_date","users:allow_availability_form_field","event:advanced_scheduling","event:shift_max_time","event:gap_between_shifts","event:min_shift_length","event:max_shift_length","event:min_shift_apps_per_user","event:max_shift_apps_per_user","event:shift_status_default","event:shift_confirmed_status_default","event:shift_rejected_status_default","event:shift_can_withdraw_default","event:shift_can_withdraw_limit","event:shift_can_confirm_limit","event:shift_checked_in_status_default","event:shift_application_form_id_default","event:shift_checkin_form_id_default","event:shift_attended_form_id_default","event:shift_checkout_form_id_default","event:shift_feedback_form_id_default","event:self_checkin","event:self_checkin_open","event:self_checkin_close","event:self_checkout_close","event:checkin_visible_attributes","event:shift_show_demand","training:id","email:from_name","email:reply_to","email:forgot_password_template_id","email:email_verification_template_id","email:user_lockout_template_id","email:user_invitation_email_template_id","email:contact_us_email_template_id","email:admin_invitation_email_template_id","email:banner","branding:name","branding:subtitle","branding:address","branding:logo","branding:logo_mono","branding:background_image","branding:banner_image","branding:favicon","branding:primary_color","branding:secondary_color","branding:custom_css","advanced:default_dashboard","portal:visible_stats"]},"meta":[],"visibility_rules":[],"status":"approved","status_reason":null,"sort_order":0,"start_timestamp":null,"end_timestamp":null,"notes":null,"contact_firstname":null,"contact_lastname":null,"contact_email":null,"contact_phone":null,"support_manager_email":"support_manager@rosterfy.com","allow_deletion_request":1,"organization_type":null,"contract_start_date":"2026-06-09","contract_end_date":"2027-06-09","billing_contact_email":"billing_contact@rosterfy.com","billing_support_email":"billing_support@rosterfy.com","is_enabled":1,"additional_billing_support_email":"additional_billing_contact@rosterfy.com","delete_requested_at":null,"is_archived":0,"trial_ends_at":null,"can_erase":0,"deleted_at":null,"is_erased":0,"created_at":"2026-06-09T05:33:32.000000Z","updated_at":"2026-06-09T07:08:01.000000Z"},"nice":{"rrn":"rrn:local:1:account:20101","address":"No Address","address_oneline":"No Address","account_type_id":"Enterprise","account_type_id:value":3,"account_type_id:array":"Enterprise","allow_deletion_request":"Yes","contact_firstname":"","contact_lastname":"","contact_phone:qr_code_value":"","contact_phone":"","contact_phone:raw":"","contract_end_date":"Jun 9, 2027","contract_end_date__dayofweek":"Wednesday","contract_start_date":"Jun 9, 2026","contract_start_date__dayofweek":"Tuesday","name":"Rosterfy Subaccount","notes":"","organization_type":null,"organization_type:value":null,"organization_type:array":null,"status":"Approved","status:value":"approved","status:array":"approved","status_reason":"","created_at":"2026-06-09 05:33:32","url":"https://sub.rosterfy2.localhost.com/","branding_name":"Rosterfy","branding_subtitle":null,"branding_logo":null,"branding_logo_mono":null,"branding_logo_stacked":null,"branding_banner":null,"branding_description":null,"branding_primary_color":"#3131c7","branding_complimentary_color":null,"branding_secondary_color":"#38b6ff","register":false,"organisation_contact":" ","has_subaccount_approved_email_template":false,"has_subaccount_rejected_email_template":false,"parent_account_name":"Rosterfy2"},"permissions":{"read":true,"update":false,"delete":false}},"certificate":null},"permissions":{"read":true,"update":true,"delete":true}}]},"id":"schema_321"},"schema_322":{"kind":"json-schema","data":{"type":"object","properties":{"success_message":{"type":"string","description":"The end of course message, shown when a user finishes the module. HTML, maximum 64,000 characters.","examples":["Quia quo est et consequatur qui quis quibusdam."]},"name":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name of the module. Maximum 255 characters. Translatable: send a plain string to set it for the request locale, or an object keyed by locale such as {\"en-US\": \"Induction\"}."},"children":[]}]}]}],"examples":["Paper Goods Machine Operator_EBMsffvoa9Ht"]},"estimated_complete_time":{"type":"integer","description":"How long the module is expected to take, in minutes.","examples":[11]},"publish":{"type":"boolean","description":"Whether the module is published. Until it is, the module is not visible in the portal.","examples":[1]},"is_archived":{"type":"boolean","description":"Whether the module is archived. The mass-archive endpoint sets this field in bulk.","examples":[0]},"is_elective":{"type":"boolean","description":"Whether any user who can access training may complete this module.","examples":[0]},"is_inheritable":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether accounts below the owning account may use this module. Reflected in the response as nice.acts_as_native."},"children":[]}]}]}],"examples":[0]},"type_id":{"type":"integer","description":"The ID of the training type to categorise this module under. Used for reporting and filtering, and optional.","examples":[1]},"service":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The training provider. One of online, scorm, scorm_upload or bespoke for modules Rosterfy hosts, or the code of an external provider. A module whose service is not one of the four local values reads as external, and the update endpoint ignores this field for those modules."},"children":[]}]}]}],"examples":["online"]},"external_id":{"type":"string","description":"The ID of the module in the external training provider. Recorded when the module is synced from that provider, and sent back to it on assignment and completion.","examples":[null]},"meta":{"type":"object","description":"Provider and behaviour options for the module. The documented subkeys follow. On create this object is stored as sent; on update it is merged into the stored object, so omitted subkeys keep their current values.","properties":{"onetime":{"type":"boolean","description":"Whether a user is blocked from repeating the module if they do not pass on the first attempt.","examples":[true]},"score":{"type":"boolean","description":"Whether a score is recorded. The user always moves to the next step when there is a question, and the total correct answers make up the score.","examples":[true]},"inform_answer":{"type":"boolean","description":"Whether the user is told if their answer was correct.","examples":[true]},"show_correct":{"type":"boolean","description":"Whether the user is shown the correct answers.","examples":[true]},"inform_score":{"type":"boolean","description":"Whether the user is shown the percentage required to pass and their own score at the end.","examples":[true]},"template_id":{"type":"integer","description":"The ID of the email template to send when a user finishes the module.","examples":[1]},"code":{"type":"string","description":"The course code the module has in the external provider. Set when the module is synced from that provider.","examples":[null]},"original_id":{"type":"string","description":"The original module ID in the external provider. Set when the module is synced from that provider.","examples":[null]},"source":{"type":"string","description":"The name of the external provider the module was synced from.","examples":[null]},"height":{"type":"integer","description":"The height of the SCORM frame in the portal, in pixels. Must be under 5000. Defaults to 600.","examples":[1]},"suspend":{"type":"boolean","description":"Whether the user is forced to restart the SCORM module if they return after starting it.","examples":[true]},"redirect_url":{"type":"string","description":"The URL the user is redirected to from the portal to take the training. Required when service is bespoke.","examples":[null]},"entrypoint":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The file the SCORM package starts at, usually index.html or story.html. Required when service is scorm or scorm_upload."},"children":[]}]}]}],"examples":[null]},"complete":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The status the SCORM file emits to tell Rosterfy the training is complete, usually complete or passed. Your SCORM provider will tell you this status. Required when service is scorm or scorm_upload."},"children":[]}]}]}],"examples":[null]}},"examples":[[]]},"ttl":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How long a completion stays valid, in seconds. A user is required to retake the module once it lapses, and re-completing resets the expiry. Only applied when greater than 0, and forced to 0 when can_expire is sent as false."},"children":[]}]}]}],"examples":[0]},"is_library":{"type":"boolean","description":"Stored, but read by nothing in the platform.","examples":[0]},"form_id":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the form a user completes before starting the module without a Rosterfy account. Setting it is also what makes the module readable unauthenticated - see the read endpoint. Cleared when anonymous_enable is sent as false."},"children":[]}]}]}],"examples":[1]},"certificate_id":{"type":"integer","description":"The ID of the certificate to award when the module is completed successfully.","examples":[1]},"pass_score":{"type":"integer","description":"The percentage a user must reach to be marked as passed, from 0 to 100. Applies when meta.score is true.","examples":[0]},"sort_order":{"type":"integer","description":"The position of the module where listings are ordered by sort order.","examples":[0]},"scorm_upload":{"type":"string","description":"URL of an uploaded SCORM zip, up to 100MB, which Rosterfy unzips and stores. Only acted on by the update endpoint; on create the field is accepted and ignored.","examples":[null]},"short_description":{"type":"string","description":"A short summary of the module. Not validated by the server; anything the column accepts is stored.","examples":[null]},"thumbnail_url":{"type":"string","description":"URL of, or an upload for, the module thumbnail. Recommended 245x150 pixels. Not validated by the server.","examples":[null]},"can_expire":{"type":"boolean","description":"Whether completions of this module expire. Not stored; sending it as false is what sets ttl to 0.","examples":[true]},"anonymous_enable":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether the module may be completed by someone without a Rosterfy account. Not stored; sending it as false is what clears form_id and meta.template_id."},"children":[]}]}]}],"examples":[true]}}},"id":"schema_322"},"schema_323":{"kind":"json-schema","data":{"type":"array","description":"A list of extras to include in the response. These are objects or arrays that are not part of\nthe model's primary attributes, such as stats and counts.\nFor fast responses, avoid requesting them if you don't need them. ","items":{"type":"string","enum":["statuslog"]},"examples":[["statuslog"]]},"id":"schema_323"},"schema_324":{"kind":"json-schema","data":{"type":"array","description":"A list of relations to include in the response. May be single records or collections.\nIt is often more efficient to retrieve this way, to avoid follow-up API calls.","items":{"type":"string","enum":["account"]},"examples":[["account"]]},"id":"schema_324"},"schema_325":{"kind":"json-schema","data":{"type":"array","items":{"type":"object","properties":{"current_page":{"type":"integer","examples":[1]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"training_id":{"type":"integer","examples":[1]},"user_id":{"type":"integer","examples":[1234]},"steps_completed":{"type":"integer","examples":[2]},"status":{"type":"string","examples":["INCOMPLETE"]},"score":{"type":"integer","examples":[0]},"expires_at":{"type":["string","null"],"examples":[null]},"meta":{"type":["string","null"],"examples":[null]},"external_id":{"type":["string","null"],"examples":[null]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-06-09T05:36:32.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:32.000000Z"]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:training_user:1"]},"training_name":{"type":"string","examples":["Site Safety Induction"]},"training_service":{"type":"string","examples":["online"]},"training_meta":{"type":"object","properties":{"middleware":{"type":"string","examples":["https://example.rosterfy.com/scorm/index.html"]}}},"has_history":{"type":"boolean","examples":[false]},"training_success_message":{"type":"string","examples":["Thanks for completing this module."]},"is_expired":{"type":"boolean","examples":[false]},"status":{"type":"string","examples":["Incomplete"]},"binary_status":{"type":"boolean","examples":[false]},"finished_status":{"type":"boolean","examples":[false]},"score_percentage":{"type":"integer","examples":[0]},"steps_percentage":{"type":"number","examples":[66.67]}}},"relations":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}}},"examples":[[{"object":{"id":1,"training_id":1,"user_id":1234,"steps_completed":2,"status":"INCOMPLETE","score":0,"expires_at":null,"meta":null,"external_id":null,"deleted_at":null,"created_at":"2026-06-09T05:36:32.000000Z","updated_at":"2026-06-09T05:36:32.000000Z"},"nice":{"rrn":"rrn:local:20101:training_user:1","training_name":"Site Safety Induction","training_service":"online","training_meta":{"middleware":"https://example.rosterfy.com/scorm/index.html"},"has_history":false,"training_success_message":"Thanks for completing this module.","is_expired":false,"status":"Incomplete","binary_status":false,"finished_status":false,"score_percentage":0,"steps_percentage":66.67},"relations":[],"permissions":{"read":true,"update":true,"delete":true}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}]]},"first_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/training/{training}/user?per_page=5&_locale=en-US&page=1"]},"from":{"type":"integer","examples":[1]},"next_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/training/{training}/user?per_page=5&_locale=en-US&page=2"]},"path":{"type":"string","examples":["https://example.rosterfy.com/api/v2/training/{training}/user"]},"per_page":{"type":"integer","examples":[5]},"prev_page_url":{"type":["string","null"],"examples":[null]},"to":{"type":"integer","examples":[5]}}},"examples":[[{"current_page":1,"data":[{"object":{"id":1,"training_id":1,"user_id":1234,"steps_completed":2,"status":"INCOMPLETE","score":0,"expires_at":null,"meta":null,"external_id":null,"deleted_at":null,"created_at":"2026-06-09T05:36:32.000000Z","updated_at":"2026-06-09T05:36:32.000000Z"},"nice":{"rrn":"rrn:local:20101:training_user:1","training_name":"Site Safety Induction","training_service":"online","training_meta":{"middleware":"https://example.rosterfy.com/scorm/index.html"},"has_history":false,"training_success_message":"Thanks for completing this module.","is_expired":false,"status":"Incomplete","binary_status":false,"finished_status":false,"score_percentage":0,"steps_percentage":66.67},"relations":[],"permissions":{"read":true,"update":true,"delete":true}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}],"first_page_url":"https://example.rosterfy.com/api/v2/training/{training}/user?per_page=5&_locale=en-US&page=1","from":1,"next_page_url":"https://example.rosterfy.com/api/v2/training/{training}/user?per_page=5&_locale=en-US&page=2","path":"https://example.rosterfy.com/api/v2/training/{training}/user","per_page":5,"prev_page_url":null,"to":5}]]},"id":"schema_325"},"schema_326":{"kind":"json-schema","data":{"type":"object","properties":{"user_id":{"type":"integer","description":"The user the module is assigned to. Required on create. Sending it on update hands the assignment, and the progress recorded against it, to a different user - so omit it unless that is what you want.","examples":[1234]},"status":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Where the user has got to. One of COMPLETE, INCOMPLETE, PASSED, FAILED or EXEMPT. Defaults to INCOMPLETE on create. Setting it to COMPLETE also sets steps_completed to the module's full step count; setting it back to INCOMPLETE from COMPLETE resets steps_completed to 0."},"children":[]}]}]}],"examples":["INCOMPLETE"]}},"required":["user_id"]},"id":"schema_326"},"schema_327":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"training_id":{"type":"integer","examples":[1]},"user_id":{"type":"integer","examples":[1234]},"steps_completed":{"type":"integer","examples":[2]},"status":{"type":"string","examples":["INCOMPLETE"]},"score":{"type":"integer","examples":[0]},"expires_at":{"type":["string","null"],"examples":[null]},"meta":{"type":["string","null"],"examples":[null]},"external_id":{"type":["string","null"],"examples":[null]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-06-09T05:36:32.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:32.000000Z"]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:training_user:1"]},"training_name":{"type":"string","examples":["Site Safety Induction"]},"training_service":{"type":"string","examples":["online"]},"training_meta":{"type":"object","properties":{"middleware":{"type":"string","examples":["https://example.rosterfy.com/scorm/index.html"]}}},"has_history":{"type":"boolean","examples":[false]},"training_success_message":{"type":"string","examples":["Thanks for completing this module."]},"is_expired":{"type":"boolean","examples":[false]},"status":{"type":"string","examples":["Incomplete"]},"binary_status":{"type":"boolean","examples":[false]},"finished_status":{"type":"boolean","examples":[false]},"score_percentage":{"type":"integer","examples":[0]},"steps_percentage":{"type":"number","examples":[66.67]}}},"relations":{"type":"object","properties":{}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}},"examples":[{"object":{"id":1,"training_id":1,"user_id":1234,"steps_completed":2,"status":"INCOMPLETE","score":0,"expires_at":null,"meta":null,"external_id":null,"deleted_at":null,"created_at":"2026-06-09T05:36:32.000000Z","updated_at":"2026-06-09T05:36:32.000000Z"},"nice":{"rrn":"rrn:local:20101:training_user:1","training_name":"Site Safety Induction","training_service":"online","training_meta":{"middleware":"https://example.rosterfy.com/scorm/index.html"},"has_history":false,"training_success_message":"Thanks for completing this module.","is_expired":false,"status":"Incomplete","binary_status":false,"finished_status":false,"score_percentage":0,"steps_percentage":66.67},"relations":{},"permissions":{"read":true,"update":true,"delete":true}}]},"id":"schema_327"},"schema_328":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","examples":["This Training has already been assigned to this User"]}},"examples":[{"message":"This Training has already been assigned to this User"}]},"id":"schema_328"},"schema_329":{"kind":"json-schema","data":{"type":"object","properties":{"applyTo":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to assign the module to the users named in selected. Any other value assigns it to every user the caller can see, narrowed by filter if one is sent."},"children":[]}]}]}],"examples":[null]},"selected":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The IDs of the users to assign. Required when applyTo is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and ignored otherwise."},"children":[]}]}]}],"items":{"type":"integer"},"examples":[[]]}},"required":["applyTo"]},"id":"schema_329"},"schema_330":{"kind":"json-schema","data":{"type":"object","properties":{"training_id":{"type":"integer","description":"The module the assignment belongs to. Taken from the URL on create, so there is no need to send it. Sending a different one on update moves the assignment to that module, and because the response is then read back against the module in the URL, the request returns 404 even though the move has been applied. Omit it.","examples":[1]},"user_id":{"type":"integer","description":"The user the module is assigned to. Required on create. Sending it on update hands the assignment, and the progress recorded against it, to a different user - so omit it unless that is what you want.","examples":[1234]},"status":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Where the user has got to. One of COMPLETE, INCOMPLETE, PASSED, FAILED or EXEMPT. Defaults to INCOMPLETE on create. Setting it to COMPLETE also sets steps_completed to the module's full step count; setting it back to INCOMPLETE from COMPLETE resets steps_completed to 0."},"children":[]}]}]}],"examples":["INCOMPLETE"]},"steps_completed":{"type":"integer","description":"How many of the module's steps the user has finished. Sending a value equal to the module's total step count marks the assignment COMPLETE.","examples":[2]},"expires_at":{"type":"string","description":"When the completion stops counting, as YYYY-MM-DD HH:MM:SS. Set automatically from the module's retake period when the assignment completes, so it rarely needs sending.","examples":[null]},"score":{"type":"integer","description":"The score the user achieved. Stored as sent and not validated, so keep it a whole number.","examples":[0]},"external_id":{"type":"string","description":"Your own reference for the assignment, or the status reported by an externally hosted course. Stored as sent and not validated.","examples":[null]},"meta":{"type":"object","description":"Free-form object stored against the assignment. Rosterfy keeps the completion history under a history key, so send a full object rather than a partial one.","properties":{},"examples":["{}"]}}},"id":"schema_330"},"schema_331":{"kind":"json-schema","data":{"type":"array","description":"A list of extras to include in the response. These are objects or arrays that are not part of\nthe model's primary attributes, such as stats and counts.\nFor fast responses, avoid requesting them if you don't need them. ","items":{"type":"string","enum":["demand"]},"examples":[["demand"]]},"id":"schema_331"},"schema_332":{"kind":"json-schema","data":{"type":"array","items":{"type":"object","properties":{"current_page":{"type":"integer","examples":[1]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"account_id":{"type":"integer","examples":[20101]},"headcount_functional_area_type_id":{"type":"integer","examples":[1]},"name":{"type":"string","examples":["Guest Services"]},"frontend_name":{"type":"string","examples":["Guest Services"]},"code":{"type":"string","examples":["GUESTSERVICES"]},"target":{"type":"integer","examples":[50]},"auto_update_mode":{"type":"integer","examples":[0]},"rules":{"type":"array","examples":[[]]},"training_ids":{"type":"array","items":{"type":"integer"},"examples":[[1]]},"is_system":{"type":"integer","examples":[0]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"updated_by":{"type":"integer","examples":[1234]},"uuid":{"type":"string","examples":["270eebe1-bc48-4ecf-a065-2c5ff65b33b0"]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:functional_area:1"]}}},"relations":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}}},"examples":[[{"object":{"id":1,"account_id":20101,"headcount_functional_area_type_id":1,"name":"Guest Services","frontend_name":"Guest Services","code":"GUESTSERVICES","target":50,"auto_update_mode":0,"rules":[],"training_ids":[1],"is_system":0,"deleted_at":null,"created_at":"2026-06-09T05:36:16.000000Z","updated_at":"2026-06-09T05:36:16.000000Z","updated_by":1234,"uuid":"270eebe1-bc48-4ecf-a065-2c5ff65b33b0"},"nice":{"rrn":"rrn:local:20101:functional_area:1"},"relations":[],"permissions":{"read":true,"update":true,"delete":true}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}]]},"first_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/headcount/functionalarea?per_page=5&_locale=en-US&page=1"]},"from":{"type":"integer","examples":[1]},"next_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/headcount/functionalarea?per_page=5&_locale=en-US&page=2"]},"path":{"type":"string","examples":["https://example.rosterfy.com/api/v2/headcount/functionalarea"]},"per_page":{"type":"integer","examples":[5]},"prev_page_url":{"type":["string","null"],"examples":[null]},"to":{"type":"integer","examples":[5]}}},"examples":[[{"current_page":1,"data":[{"object":{"id":1,"account_id":20101,"headcount_functional_area_type_id":1,"name":"Guest Services","frontend_name":"Guest Services","code":"GUESTSERVICES","target":50,"auto_update_mode":0,"rules":[],"training_ids":[1],"is_system":0,"deleted_at":null,"created_at":"2026-06-09T05:36:16.000000Z","updated_at":"2026-06-09T05:36:16.000000Z","updated_by":1234,"uuid":"270eebe1-bc48-4ecf-a065-2c5ff65b33b0"},"nice":{"rrn":"rrn:local:20101:functional_area:1"},"relations":[],"permissions":{"read":true,"update":true,"delete":true}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}],"first_page_url":"https://example.rosterfy.com/api/v2/headcount/functionalarea?per_page=5&_locale=en-US&page=1","from":1,"next_page_url":"https://example.rosterfy.com/api/v2/headcount/functionalarea?per_page=5&_locale=en-US&page=2","path":"https://example.rosterfy.com/api/v2/headcount/functionalarea","per_page":5,"prev_page_url":null,"to":5}]]},"id":"schema_332"},"schema_333":{"kind":"json-schema","data":{"type":"object","properties":{"name":{"type":"string","description":"The name administrators see. Required.","examples":["Guest Services"]},"frontend_name":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name volunteers see in the portal. Required, and shown in place of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to anyone without administrator access, so it is worth setting even when the two match."},"children":[]}]}]}],"examples":["Guest Services"]},"code":{"type":"string","description":"A short reference for the group, unique within the account. Letters, numbers, dashes and underscores only - spaces and punctuation are rejected. Stored and returned in upper case whatever case it is sent in.","examples":["GUESTSERVICES"]},"headcount_functional_area_type_id":{"type":"integer","description":"The ID of the group type to file this group under. Optional; omit or send null to leave the group untyped.","examples":[1]},"target":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How many people this group is aiming to have. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" means no limit. Cannot be negative."},"children":[]}]}]}],"examples":[50]},"auto_update_mode":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether membership is maintained automatically from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rules"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and in which direction: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" off, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" add and remove, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" add only, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"3"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" remove only. When this is anything other than "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rules"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must be present and well formed or the request is rejected."},"children":[]}]}]}],"examples":[0]},"rules":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The membership conditions used when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"auto_update_mode"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is on, as a list of condition objects built from the account's own user fields. Each condition names a field, a comparison and a value. Build these in the admin console and send back what it produces rather than composing them by hand - the set of addressable fields is specific to the account. "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This field is cleared whenever it is omitted"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", so resend it on every update to a group that has automatic updating switched on; omitting it there clears the conditions and the request is rejected."},"children":[]}]}]}],"items":{"type":"object"},"examples":[[]]},"training_ids":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The IDs of the training modules assigned to anyone who joins this group. "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Replaces the whole list"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rather than adding to it, so send every module you want kept. Omitting the field leaves the stored list untouched."},"children":[]}]}]}],"items":{"type":"integer"},"examples":[[1]]}},"required":["name","frontend_name","code"]},"id":"schema_333"},"schema_334":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"rules":{"type":"array","examples":[[]]},"auto_update_mode":{"type":"integer","examples":[0]},"name":{"type":"string","examples":["Guest Services"]},"frontend_name":{"type":"string","examples":["Guest Services"]},"code":{"type":"string","examples":["GUESTSERVICES"]},"headcount_functional_area_type_id":{"type":"integer","examples":[1]},"target":{"type":"integer","examples":[50]},"training_ids":{"type":"array","items":{"type":"integer"},"examples":[[1]]},"account_id":{"type":"integer","examples":[20101]},"updated_by":{"type":"integer","examples":[1234]},"uuid":{"type":"string","examples":["428585a9-f02d-4ca8-8383-35b1f8433f1c"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"created_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"id":{"type":"integer","examples":[1]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:functional_area:1"]}}},"relations":{"type":"object","properties":{}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}},"examples":[{"object":{"rules":[],"auto_update_mode":0,"name":"Guest Services","frontend_name":"Guest Services","code":"GUESTSERVICES","headcount_functional_area_type_id":1,"target":50,"training_ids":[1],"account_id":20101,"updated_by":1234,"uuid":"428585a9-f02d-4ca8-8383-35b1f8433f1c","updated_at":"2026-06-09T05:36:16.000000Z","created_at":"2026-06-09T05:36:16.000000Z","id":1},"nice":{"rrn":"rrn:local:20101:functional_area:1"},"relations":{},"permissions":{"read":true,"update":true,"delete":true}}]},"id":"schema_334"},"schema_335":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"account_id":{"type":"integer","examples":[20101]},"headcount_functional_area_type_id":{"type":"integer","examples":[1]},"name":{"type":"string","examples":["Guest Services"]},"frontend_name":{"type":"string","examples":["Guest Services"]},"code":{"type":"string","examples":["GUESTSERVICES"]},"target":{"type":"integer","examples":[50]},"auto_update_mode":{"type":"integer","examples":[0]},"rules":{"type":"array","examples":[[]]},"training_ids":{"type":"array","items":{"type":"integer"},"examples":[[1]]},"is_system":{"type":"integer","examples":[0]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"updated_by":{"type":"integer","examples":[1234]},"uuid":{"type":"string","examples":["270eebe1-bc48-4ecf-a065-2c5ff65b33b0"]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:functional_area:1"]}}},"relations":{"type":"object","properties":{}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}},"examples":[{"object":{"id":1,"account_id":20101,"headcount_functional_area_type_id":1,"name":"Guest Services","frontend_name":"Guest Services","code":"GUESTSERVICES","target":50,"auto_update_mode":0,"rules":[],"training_ids":[1],"is_system":0,"deleted_at":null,"created_at":"2026-06-09T05:36:16.000000Z","updated_at":"2026-06-09T05:36:16.000000Z","updated_by":1234,"uuid":"270eebe1-bc48-4ecf-a065-2c5ff65b33b0"},"nice":{"rrn":"rrn:local:20101:functional_area:1"},"relations":{},"permissions":{"read":true,"update":true,"delete":true}}]},"id":"schema_335"},"schema_336":{"kind":"json-schema","data":{"type":"object","properties":{"name":{"type":"string","description":"The name administrators see. Required.","examples":["Guest Services"]},"frontend_name":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name volunteers see in the portal. Required, and shown in place of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to anyone without administrator access, so it is worth setting even when the two match."},"children":[]}]}]}],"examples":["Guest Services"]},"code":{"type":"string","description":"A short reference for the group, unique within the account. Letters, numbers, dashes and underscores only - spaces and punctuation are rejected. Stored and returned in upper case whatever case it is sent in.","examples":["GUESTSERVICES"]},"headcount_functional_area_type_id":{"type":"integer","description":"The ID of the group type to file this group under. Optional; omit or send null to leave the group untyped.","examples":[1]},"target":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How many people this group is aiming to have. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" means no limit. Cannot be negative."},"children":[]}]}]}],"examples":[50]},"auto_update_mode":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether membership is maintained automatically from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rules"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and in which direction: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" off, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" add and remove, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" add only, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"3"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" remove only. When this is anything other than "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rules"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must be present and well formed or the request is rejected."},"children":[]}]}]}],"examples":[0]},"rules":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The membership conditions used when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"auto_update_mode"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is on, as a list of condition objects built from the account's own user fields. Each condition names a field, a comparison and a value. Build these in the admin console and send back what it produces rather than composing them by hand - the set of addressable fields is specific to the account. "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This field is cleared whenever it is omitted"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", so resend it on every update to a group that has automatic updating switched on; omitting it there clears the conditions and the request is rejected."},"children":[]}]}]}],"items":{"type":"object"},"examples":[[]]},"training_ids":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The IDs of the training modules assigned to anyone who joins this group. "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Replaces the whole list"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rather than adding to it, so send every module you want kept. Omitting the field leaves the stored list untouched."},"children":[]}]}]}],"items":{"type":"integer"},"examples":[[1]]}}},"id":"schema_336"},"schema_337":{"kind":"json-schema","data":{"type":"object","properties":{"messages":{"type":["string","null"],"examples":[null]}},"examples":[{"messages":null}]},"id":"schema_337"},"schema_338":{"kind":"json-schema","data":{"type":"array","items":{"type":"object","properties":{"current_page":{"type":"integer","examples":[1]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"headcount_functional_area_id":{"type":"integer","examples":[1]},"name":{"type":"string","examples":["Information Desk Attendant"]},"frontend_name":{"type":"string","examples":["Information Desk Attendant"]},"code":{"type":"string","examples":["INFODESK"]},"description":{"type":"string","examples":["<p>Answers visitor questions at the information desk.</p>"]},"training_ids":{"type":"array","items":{"type":"integer"},"examples":[[1]]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"uuid":{"type":"string","examples":["e17404de-d3db-4e85-81ee-4552d19da8c4"]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:job_title:1"]},"functional_area_name":{"type":"string","examples":["Guest Services"]}}},"relations":{"type":"object","properties":{"functional_area":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"account_id":{"type":"integer","examples":[20101]},"headcount_functional_area_type_id":{"type":"integer","examples":[1]},"name":{"type":"string","examples":["Guest Services"]},"frontend_name":{"type":"string","examples":["Guest Services"]},"code":{"type":"string","examples":["GUESTSERVICES"]},"target":{"type":"integer","examples":[50]},"auto_update_mode":{"type":"integer","examples":[0]},"rules":{"type":"array","examples":[[]]},"training_ids":{"type":"array","items":{"type":"integer"},"examples":[[1]]},"is_system":{"type":"integer","examples":[0]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"updated_by":{"type":"integer","examples":[1234]},"uuid":{"type":"string","examples":["270eebe1-bc48-4ecf-a065-2c5ff65b33b0"]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:functional_area:1"]}}}}}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}}},"examples":[[{"object":{"id":1,"headcount_functional_area_id":1,"name":"Information Desk Attendant","frontend_name":"Information Desk Attendant","code":"INFODESK","description":"<p>Answers visitor questions at the information desk.</p>","training_ids":[1],"deleted_at":null,"created_at":"2026-06-09T05:36:16.000000Z","updated_at":"2026-06-09T05:36:16.000000Z","uuid":"e17404de-d3db-4e85-81ee-4552d19da8c4"},"nice":{"rrn":"rrn:local:20101:job_title:1","functional_area_name":"Guest Services"},"relations":{"functional_area":{"object":{"id":1,"account_id":20101,"headcount_functional_area_type_id":1,"name":"Guest Services","frontend_name":"Guest Services","code":"GUESTSERVICES","target":50,"auto_update_mode":0,"rules":[],"training_ids":[1],"is_system":0,"deleted_at":null,"created_at":"2026-06-09T05:36:16.000000Z","updated_at":"2026-06-09T05:36:16.000000Z","updated_by":1234,"uuid":"270eebe1-bc48-4ecf-a065-2c5ff65b33b0"},"nice":{"rrn":"rrn:local:20101:functional_area:1"}}},"permissions":{"read":true,"update":true,"delete":true}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}]]},"first_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/headcount/functionalarea/{functionalarea}/jobtitle?per_page=5&_locale=en-US&page=1"]},"from":{"type":"integer","examples":[1]},"next_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/headcount/functionalarea/{functionalarea}/jobtitle?per_page=5&_locale=en-US&page=2"]},"path":{"type":"string","examples":["https://example.rosterfy.com/api/v2/headcount/functionalarea/{functionalarea}/jobtitle"]},"per_page":{"type":"integer","examples":[5]},"prev_page_url":{"type":["string","null"],"examples":[null]},"to":{"type":"integer","examples":[5]}}},"examples":[[{"current_page":1,"data":[{"object":{"id":1,"headcount_functional_area_id":1,"name":"Information Desk Attendant","frontend_name":"Information Desk Attendant","code":"INFODESK","description":"<p>Answers visitor questions at the information desk.</p>","training_ids":[1],"deleted_at":null,"created_at":"2026-06-09T05:36:16.000000Z","updated_at":"2026-06-09T05:36:16.000000Z","uuid":"e17404de-d3db-4e85-81ee-4552d19da8c4"},"nice":{"rrn":"rrn:local:20101:job_title:1","functional_area_name":"Guest Services"},"relations":{"functional_area":{"object":{"id":1,"account_id":20101,"headcount_functional_area_type_id":1,"name":"Guest Services","frontend_name":"Guest Services","code":"GUESTSERVICES","target":50,"auto_update_mode":0,"rules":[],"training_ids":[1],"is_system":0,"deleted_at":null,"created_at":"2026-06-09T05:36:16.000000Z","updated_at":"2026-06-09T05:36:16.000000Z","updated_by":1234,"uuid":"270eebe1-bc48-4ecf-a065-2c5ff65b33b0"},"nice":{"rrn":"rrn:local:20101:functional_area:1"}}},"permissions":{"read":true,"update":true,"delete":true}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}],"first_page_url":"https://example.rosterfy.com/api/v2/headcount/functionalarea/{functionalarea}/jobtitle?per_page=5&_locale=en-US&page=1","from":1,"next_page_url":"https://example.rosterfy.com/api/v2/headcount/functionalarea/{functionalarea}/jobtitle?per_page=5&_locale=en-US&page=2","path":"https://example.rosterfy.com/api/v2/headcount/functionalarea/{functionalarea}/jobtitle","per_page":5,"prev_page_url":null,"to":5}]]},"id":"schema_338"},"schema_339":{"kind":"json-schema","data":{"type":"object","properties":{"name":{"type":"string","description":"The name administrators see. Required.","examples":["Information Desk Attendant"]},"frontend_name":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name volunteers see in the portal. Required, and shown in place of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to anyone without administrator access, so it is worth setting even when the two match."},"children":[]}]}]}],"examples":["Information Desk Attendant"]},"code":{"type":"string","description":"A short reference for the role, unique across the account rather than just within the group. Letters, numbers, dashes and underscores only - spaces and punctuation are rejected. Stored and returned in upper case whatever case it is sent in.","examples":["INFODESK"]},"description":{"type":"string","description":"What the role involves, as HTML. Shown to volunteers alongside the role. Sanitised on the way out, so unsupported markup will not be returned as sent.","examples":["<p>Answers visitor questions at the information desk.</p>"]},"training_ids":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The IDs of the training modules assigned to anyone who takes on this role. "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Replaces the whole list"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rather than adding to it, so send every module you want kept. Omitting the field leaves the stored list untouched."},"children":[]}]}]}],"items":{"type":"integer"},"examples":[[1]]}},"required":["name","frontend_name","code"]},"id":"schema_339"},"schema_340":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"headcount_functional_area_id":{"type":"integer","examples":[1]},"name":{"type":"string","examples":["Information Desk Attendant"]},"frontend_name":{"type":"string","examples":["Information Desk Attendant"]},"code":{"type":"string","examples":["INFODESK"]},"description":{"type":"string","examples":["<p>Answers visitor questions at the information desk.</p>"]},"training_ids":{"type":"array","items":{"type":"integer"},"examples":[[1]]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"uuid":{"type":"string","examples":["e17404de-d3db-4e85-81ee-4552d19da8c4"]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:job_title:1"]},"functional_area_name":{"type":"string","examples":["Guest Services"]}}},"relations":{"type":"object","properties":{"functional_area":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"account_id":{"type":"integer","examples":[20101]},"headcount_functional_area_type_id":{"type":"integer","examples":[1]},"name":{"type":"string","examples":["Guest Services"]},"frontend_name":{"type":"string","examples":["Guest Services"]},"code":{"type":"string","examples":["GUESTSERVICES"]},"target":{"type":"integer","examples":[50]},"auto_update_mode":{"type":"integer","examples":[0]},"rules":{"type":"array","examples":[[]]},"training_ids":{"type":"array","items":{"type":"integer"},"examples":[[1]]},"is_system":{"type":"integer","examples":[0]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"updated_by":{"type":"integer","examples":[1234]},"uuid":{"type":"string","examples":["270eebe1-bc48-4ecf-a065-2c5ff65b33b0"]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:functional_area:1"]}}}}}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}},"examples":[{"object":{"id":1,"headcount_functional_area_id":1,"name":"Information Desk Attendant","frontend_name":"Information Desk Attendant","code":"INFODESK","description":"<p>Answers visitor questions at the information desk.</p>","training_ids":[1],"deleted_at":null,"created_at":"2026-06-09T05:36:16.000000Z","updated_at":"2026-06-09T05:36:16.000000Z","uuid":"e17404de-d3db-4e85-81ee-4552d19da8c4"},"nice":{"rrn":"rrn:local:20101:job_title:1","functional_area_name":"Guest Services"},"relations":{"functional_area":{"object":{"id":1,"account_id":20101,"headcount_functional_area_type_id":1,"name":"Guest Services","frontend_name":"Guest Services","code":"GUESTSERVICES","target":50,"auto_update_mode":0,"rules":[],"training_ids":[1],"is_system":0,"deleted_at":null,"created_at":"2026-06-09T05:36:16.000000Z","updated_at":"2026-06-09T05:36:16.000000Z","updated_by":1234,"uuid":"270eebe1-bc48-4ecf-a065-2c5ff65b33b0"},"nice":{"rrn":"rrn:local:20101:functional_area:1"}}},"permissions":{"read":true,"update":true,"delete":true}}]},"id":"schema_340"},"schema_341":{"kind":"json-schema","data":{"type":"object","properties":{"name":{"type":"string","description":"The name administrators see. Required.","examples":["Information Desk Attendant"]},"frontend_name":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name volunteers see in the portal. Required, and shown in place of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to anyone without administrator access, so it is worth setting even when the two match."},"children":[]}]}]}],"examples":["Information Desk Attendant"]},"code":{"type":"string","description":"A short reference for the role, unique across the account rather than just within the group. Letters, numbers, dashes and underscores only - spaces and punctuation are rejected. Stored and returned in upper case whatever case it is sent in.","examples":["INFODESK"]},"description":{"type":"string","description":"What the role involves, as HTML. Shown to volunteers alongside the role. Sanitised on the way out, so unsupported markup will not be returned as sent.","examples":["<p>Answers visitor questions at the information desk.</p>"]},"training_ids":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The IDs of the training modules assigned to anyone who takes on this role. "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Replaces the whole list"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rather than adding to it, so send every module you want kept. Omitting the field leaves the stored list untouched."},"children":[]}]}]}],"items":{"type":"integer"},"examples":[[1]]}}},"id":"schema_341"},"schema_342":{"kind":"json-schema","data":{"type":"array","items":{"type":"object","properties":{"current_page":{"type":"integer","examples":[1]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"name":{"type":"string","examples":["Operations"]},"sort_order":{"type":"integer","examples":[1]},"uuid":{"type":"string","examples":["f5d2192c-e3b6-4162-8e6c-5bc6f65900e9"]}}},"nice":{"type":"array","examples":[[]]},"relations":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}}},"examples":[[{"object":{"id":1,"name":"Operations","sort_order":1,"uuid":"f5d2192c-e3b6-4162-8e6c-5bc6f65900e9"},"nice":[],"relations":[],"permissions":{"read":true,"update":true,"delete":true}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}]]},"first_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/headcount/functionalarea/type?per_page=5&_locale=en-US&page=1"]},"from":{"type":"integer","examples":[1]},"next_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/headcount/functionalarea/type?per_page=5&_locale=en-US&page=2"]},"path":{"type":"string","examples":["https://example.rosterfy.com/api/v2/headcount/functionalarea/type"]},"per_page":{"type":"integer","examples":[5]},"prev_page_url":{"type":["string","null"],"examples":[null]},"to":{"type":"integer","examples":[5]}}},"examples":[[{"current_page":1,"data":[{"object":{"id":1,"name":"Operations","sort_order":1,"uuid":"f5d2192c-e3b6-4162-8e6c-5bc6f65900e9"},"nice":[],"relations":[],"permissions":{"read":true,"update":true,"delete":true}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}],"first_page_url":"https://example.rosterfy.com/api/v2/headcount/functionalarea/type?per_page=5&_locale=en-US&page=1","from":1,"next_page_url":"https://example.rosterfy.com/api/v2/headcount/functionalarea/type?per_page=5&_locale=en-US&page=2","path":"https://example.rosterfy.com/api/v2/headcount/functionalarea/type","per_page":5,"prev_page_url":null,"to":5}]]},"id":"schema_342"},"schema_343":{"kind":"json-schema","data":{"type":"object","properties":{"name":{"type":"string","description":"The name of the group type. Required. Sending a plain string sets the name for the account's default language; it is returned as a plain string in the language of the request.","examples":["Operations"]},"sort_order":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Where this type sits when types are listed together. Lower values come first, and types sharing a value keep no guaranteed order between them. Defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[1]}},"required":["name"]},"id":"schema_343"},"schema_344":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"name":{"type":"string","examples":["Operations"]},"sort_order":{"type":"integer","examples":[1]},"uuid":{"type":"string","examples":["f5d2192c-e3b6-4162-8e6c-5bc6f65900e9"]}}},"nice":{"type":"array","examples":[[]]},"relations":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}},"examples":[{"object":{"id":1,"name":"Operations","sort_order":1,"uuid":"f5d2192c-e3b6-4162-8e6c-5bc6f65900e9"},"nice":[],"relations":[],"permissions":{"read":true,"update":true,"delete":true}}]},"id":"schema_344"},"schema_345":{"kind":"json-schema","data":{"type":"object","properties":{"name":{"type":"string","description":"The name of the group type. Required. Sending a plain string sets the name for the account's default language; it is returned as a plain string in the language of the request.","examples":["Operations"]},"sort_order":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Where this type sits when types are listed together. Lower values come first, and types sharing a value keep no guaranteed order between them. Defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[1]}}},"id":"schema_345"},"schema_346":{"kind":"json-schema","data":{"type":"object","properties":{"selected":{"type":"array","description":"The IDs of the people to add to the group. Required - a request without it is not found rather than rejected as invalid. IDs that do not resolve, belong to another account, or are already in the group are skipped without being reported.","items":{"type":"integer"},"examples":[[]]},"status":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The membership status each person is added with: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pending"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"accepted"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rejected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Required, and any other value is rejected."},"children":[]}]}]}],"examples":[null]},"applyTo":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Required, and conventionally "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". This endpoint always adds exactly the people listed in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", so the value sent does not change what happens - but the request is rejected if the field is missing. Note the camelCase name, which is deliberate here and differs from the snake_case used elsewhere."},"children":[]}]}]}],"examples":[null]}},"required":["selected","status","applyTo"]},"id":"schema_346"},"schema_347":{"kind":"json-schema","data":{"type":"array","items":{"type":"object","properties":{"current_page":{"type":"integer","examples":[1]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"account_id":{"type":"integer","examples":[20101]},"headcount_location_type_id":{"type":"integer","examples":[1]},"name":{"type":"string","examples":["Main Campus"]},"frontend_name":{"type":"string","examples":["Main Campus"]},"code":{"type":"string","examples":["MAINCAMPUS"]},"training_ids":{"type":"array","items":{"type":"integer"},"examples":[[1]]},"is_system":{"type":"integer","examples":[0]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"uuid":{"type":"string","examples":["ec98790e-5bab-4ad7-9357-31556e2efbc4"]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:location:1"]},"headcount_location_type_name":{"type":"string","examples":["Stadium"]}}},"relations":{"type":"object","properties":{"headcount_location_type":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"name":{"type":"string","examples":["Stadium"]},"sort_order":{"type":"integer","examples":[1]},"uuid":{"type":"string","examples":["bf46e175-87a9-4968-8e58-21efec6873a2"]}}},"nice":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}}}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}}},"examples":[[{"object":{"id":1,"account_id":20101,"headcount_location_type_id":1,"name":"Main Campus","frontend_name":"Main Campus","code":"MAINCAMPUS","training_ids":[1],"is_system":0,"deleted_at":null,"created_at":"2026-06-09T05:36:16.000000Z","updated_at":"2026-06-09T05:36:16.000000Z","uuid":"ec98790e-5bab-4ad7-9357-31556e2efbc4"},"nice":{"rrn":"rrn:local:20101:location:1","headcount_location_type_name":"Stadium"},"relations":{"headcount_location_type":{"object":{"id":1,"name":"Stadium","sort_order":1,"uuid":"bf46e175-87a9-4968-8e58-21efec6873a2"},"nice":[],"permissions":{"read":true,"update":true,"delete":true}}},"permissions":{"read":true,"update":true,"delete":true}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}]]},"first_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/headcount/location?per_page=5&_locale=en-US&page=1"]},"from":{"type":"integer","examples":[1]},"next_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/headcount/location?per_page=5&_locale=en-US&page=2"]},"path":{"type":"string","examples":["https://example.rosterfy.com/api/v2/headcount/location"]},"per_page":{"type":"integer","examples":[5]},"prev_page_url":{"type":["string","null"],"examples":[null]},"to":{"type":"integer","examples":[5]}}},"examples":[[{"current_page":1,"data":[{"object":{"id":1,"account_id":20101,"headcount_location_type_id":1,"name":"Main Campus","frontend_name":"Main Campus","code":"MAINCAMPUS","training_ids":[1],"is_system":0,"deleted_at":null,"created_at":"2026-06-09T05:36:16.000000Z","updated_at":"2026-06-09T05:36:16.000000Z","uuid":"ec98790e-5bab-4ad7-9357-31556e2efbc4"},"nice":{"rrn":"rrn:local:20101:location:1","headcount_location_type_name":"Stadium"},"relations":{"headcount_location_type":{"object":{"id":1,"name":"Stadium","sort_order":1,"uuid":"bf46e175-87a9-4968-8e58-21efec6873a2"},"nice":[],"permissions":{"read":true,"update":true,"delete":true}}},"permissions":{"read":true,"update":true,"delete":true}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}],"first_page_url":"https://example.rosterfy.com/api/v2/headcount/location?per_page=5&_locale=en-US&page=1","from":1,"next_page_url":"https://example.rosterfy.com/api/v2/headcount/location?per_page=5&_locale=en-US&page=2","path":"https://example.rosterfy.com/api/v2/headcount/location","per_page":5,"prev_page_url":null,"to":5}]]},"id":"schema_347"},"schema_348":{"kind":"json-schema","data":{"type":"object","properties":{"name":{"type":"string","description":"The name administrators see. Required.","examples":["Main Campus"]},"frontend_name":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name volunteers see in the portal. Required, and shown in place of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to anyone without administrator access, so it is worth setting even when the two match."},"children":[]}]}]}],"examples":["Main Campus"]},"code":{"type":"string","description":"A short reference for the location, unique within the account regardless of case. Letters, numbers, dashes and underscores only - spaces and punctuation are rejected. Stored and returned in upper case whatever case it is sent in.","examples":["MAINCAMPUS"]},"training_ids":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The IDs of the training modules assigned to anyone who accepts a role at this location. "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Replaces the whole list"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rather than adding to it, so send every module you want kept. Omitting the field leaves the stored list untouched."},"children":[]}]}]}],"items":{"type":"integer"},"examples":[[1]]},"headcount_location_type_id":{"type":"integer","description":"The ID of the location type to file this location under. Optional; omit or send null to leave the location untyped. Must be the ID of a type the account holds.","examples":[1]}},"required":["name","frontend_name","code"]},"id":"schema_348"},"schema_349":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"name":{"type":"string","examples":["Main Campus"]},"frontend_name":{"type":"string","examples":["Main Campus"]},"headcount_location_type_id":{"type":"integer","examples":[1]},"code":{"type":"string","examples":["MAINCAMPUS"]},"training_ids":{"type":"array","items":{"type":"integer"},"examples":[[1]]},"account_id":{"type":"integer","examples":[20101]},"uuid":{"type":"string","examples":["ec98790e-5bab-4ad7-9357-31556e2efbc4"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"created_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"id":{"type":"integer","examples":[1]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:location:1"]},"headcount_location_type_name":{"type":"string","examples":["Stadium"]}}},"relations":{"type":"object","properties":{"headcount_location_type":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"name":{"type":"string","examples":["Stadium"]},"sort_order":{"type":"integer","examples":[1]},"uuid":{"type":"string","examples":["bf46e175-87a9-4968-8e58-21efec6873a2"]}}},"nice":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}}}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}},"examples":[{"object":{"name":"Main Campus","frontend_name":"Main Campus","headcount_location_type_id":1,"code":"MAINCAMPUS","training_ids":[1],"account_id":20101,"uuid":"ec98790e-5bab-4ad7-9357-31556e2efbc4","updated_at":"2026-06-09T05:36:16.000000Z","created_at":"2026-06-09T05:36:16.000000Z","id":1},"nice":{"rrn":"rrn:local:20101:location:1","headcount_location_type_name":"Stadium"},"relations":{"headcount_location_type":{"object":{"id":1,"name":"Stadium","sort_order":1,"uuid":"bf46e175-87a9-4968-8e58-21efec6873a2"},"nice":[],"permissions":{"read":true,"update":true,"delete":true}}},"permissions":{"read":true,"update":true,"delete":true}}]},"id":"schema_349"},"schema_350":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"account_id":{"type":"integer","examples":[20101]},"headcount_location_type_id":{"type":"integer","examples":[1]},"name":{"type":"string","examples":["Main Campus"]},"frontend_name":{"type":"string","examples":["Main Campus"]},"code":{"type":"string","examples":["MAINCAMPUS"]},"training_ids":{"type":"array","items":{"type":"integer"},"examples":[[1]]},"is_system":{"type":"integer","examples":[0]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"uuid":{"type":"string","examples":["ec98790e-5bab-4ad7-9357-31556e2efbc4"]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:location:1"]},"headcount_location_type_name":{"type":"string","examples":["Stadium"]}}},"relations":{"type":"object","properties":{"headcount_location_type":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"name":{"type":"string","examples":["Stadium"]},"sort_order":{"type":"integer","examples":[1]},"uuid":{"type":"string","examples":["bf46e175-87a9-4968-8e58-21efec6873a2"]}}},"nice":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}}}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}},"examples":[{"object":{"id":1,"account_id":20101,"headcount_location_type_id":1,"name":"Main Campus","frontend_name":"Main Campus","code":"MAINCAMPUS","training_ids":[1],"is_system":0,"deleted_at":null,"created_at":"2026-06-09T05:36:16.000000Z","updated_at":"2026-06-09T05:36:16.000000Z","uuid":"ec98790e-5bab-4ad7-9357-31556e2efbc4"},"nice":{"rrn":"rrn:local:20101:location:1","headcount_location_type_name":"Stadium"},"relations":{"headcount_location_type":{"object":{"id":1,"name":"Stadium","sort_order":1,"uuid":"bf46e175-87a9-4968-8e58-21efec6873a2"},"nice":[],"permissions":{"read":true,"update":true,"delete":true}}},"permissions":{"read":true,"update":true,"delete":true}}]},"id":"schema_350"},"schema_351":{"kind":"json-schema","data":{"type":"object","properties":{"name":{"type":"string","description":"The name administrators see. Required.","examples":["Main Campus"]},"frontend_name":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name volunteers see in the portal. Required, and shown in place of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to anyone without administrator access, so it is worth setting even when the two match."},"children":[]}]}]}],"examples":["Main Campus"]},"code":{"type":"string","description":"A short reference for the location, unique within the account regardless of case. Letters, numbers, dashes and underscores only - spaces and punctuation are rejected. Stored and returned in upper case whatever case it is sent in.","examples":["MAINCAMPUS"]},"training_ids":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The IDs of the training modules assigned to anyone who accepts a role at this location. "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Replaces the whole list"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rather than adding to it, so send every module you want kept. Omitting the field leaves the stored list untouched."},"children":[]}]}]}],"items":{"type":"integer"},"examples":[[1]]},"headcount_location_type_id":{"type":"integer","description":"The ID of the location type to file this location under. Optional; omit or send null to leave the location untyped. Must be the ID of a type the account holds.","examples":[1]}}},"id":"schema_351"},"schema_352":{"kind":"json-schema","data":{"type":"array","items":{"type":"object","properties":{"current_page":{"type":"integer","examples":[1]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"headcount_location_id":{"type":"integer","examples":[1]},"name":{"type":"string","examples":["North Gate"]},"frontend_name":{"type":"string","examples":["North Gate"]},"code":{"type":"string","examples":["NORTHGATE"]},"is_virtual":{"type":"integer","examples":[0]},"description":{"type":"string","examples":["<p>Main pedestrian entrance.</p>"]},"is_system":{"type":"integer","examples":[0]},"training_ids":{"type":"array","items":{"type":"integer"},"examples":[[1]]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"uuid":{"type":"string","examples":["f64e8d2b-7f0d-42fb-91bc-98a098a7f191"]},"address":{"type":"object","properties":{"iso":{"type":"string","examples":["AUS"]},"region_code":{"type":"string","examples":["Example Region"]},"coordinates":{"type":"object","properties":{"latitude":{"type":["string","null"],"examples":[null]},"longitude":{"type":["string","null"],"examples":[null]}}},"street_address_1":{"type":"string","examples":["1 Example Street"]},"street_address_2":{"type":["string","null"],"examples":[null]},"street_address_3":{"type":["string","null"],"examples":[null]},"city":{"type":"string","examples":["Example City"]},"postcode":{"type":"string","examples":["1000"]},"region":{"type":"string","examples":["Example Region"]},"country":{"type":"string","examples":["AU"]},"latitude":{"type":["string","null"],"examples":[null]},"longitude":{"type":["string","null"],"examples":[null]}}}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:venue:1"]},"address":{"type":"string","examples":["1 Example Street\nExample City\nExample Region\nAustralia\n1000"]},"address_oneline":{"type":"string","examples":["1 Example Street, Example City, Example Region, Australia, 1000"]},"address.country":{"type":"string","examples":["Australia"]},"address.country:raw":{"type":"string","examples":["AUS"]},"address.city":{"type":"string","examples":["Example City"]},"address.region":{"type":"string","examples":["Example Region"]},"address.region:raw":{"type":"string","examples":["Example Region"]},"address.postcode":{"type":"string","examples":["1000"]},"address.street_address_1":{"type":"string","examples":["1 Example Street"]},"address.street_address_2":{"type":["string","null"],"examples":[null]},"address.street_address_3":{"type":["string","null"],"examples":[null]},"address.latitude":{"type":["string","null"],"examples":[null]},"address.longitude":{"type":["string","null"],"examples":[null]},"location_name":{"type":"string","examples":["Main Campus"]},"headcount_location_type_name":{"type":"string","examples":["Stadium"]},"headcount_location_type_id":{"type":"integer","examples":[1]}}},"relations":{"type":"object","properties":{"location":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"account_id":{"type":"integer","examples":[20101]},"headcount_location_type_id":{"type":"integer","examples":[1]},"name":{"type":"string","examples":["Main Campus"]},"frontend_name":{"type":"string","examples":["Main Campus"]},"code":{"type":"string","examples":["MAINCAMPUS"]},"training_ids":{"type":"array","items":{"type":"integer"},"examples":[[1]]},"is_system":{"type":"integer","examples":[0]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"uuid":{"type":"string","examples":["ec98790e-5bab-4ad7-9357-31556e2efbc4"]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:location:1"]},"headcount_location_type_name":{"type":"string","examples":["Stadium"]}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}}}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}}},"examples":[[{"object":{"id":1,"headcount_location_id":1,"name":"North Gate","frontend_name":"North Gate","code":"NORTHGATE","is_virtual":0,"description":"<p>Main pedestrian entrance.</p>","is_system":0,"training_ids":[1],"deleted_at":null,"created_at":"2026-06-09T05:36:16.000000Z","updated_at":"2026-06-09T05:36:16.000000Z","uuid":"f64e8d2b-7f0d-42fb-91bc-98a098a7f191","address":{"iso":"AUS","region_code":"Example Region","coordinates":{"latitude":null,"longitude":null},"street_address_1":"1 Example Street","street_address_2":null,"street_address_3":null,"city":"Example City","postcode":"1000","region":"Example Region","country":"AU","latitude":null,"longitude":null}},"nice":{"rrn":"rrn:local:20101:venue:1","address":"1 Example Street\nExample City\nExample Region\nAustralia\n1000","address_oneline":"1 Example Street, Example City, Example Region, Australia, 1000","address.country":"Australia","address.country:raw":"AUS","address.city":"Example City","address.region":"Example Region","address.region:raw":"Example Region","address.postcode":"1000","address.street_address_1":"1 Example Street","address.street_address_2":null,"address.street_address_3":null,"address.latitude":null,"address.longitude":null,"location_name":"Main Campus","headcount_location_type_name":"Stadium","headcount_location_type_id":1},"relations":{"location":{"object":{"id":1,"account_id":20101,"headcount_location_type_id":1,"name":"Main Campus","frontend_name":"Main Campus","code":"MAINCAMPUS","training_ids":[1],"is_system":0,"deleted_at":null,"created_at":"2026-06-09T05:36:16.000000Z","updated_at":"2026-06-09T05:36:16.000000Z","uuid":"ec98790e-5bab-4ad7-9357-31556e2efbc4"},"nice":{"rrn":"rrn:local:20101:location:1","headcount_location_type_name":"Stadium"},"permissions":{"read":true,"update":true,"delete":true}}},"permissions":{"read":true,"update":true,"delete":true}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}]]},"first_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/headcount/location/{location}/venue?per_page=5&_locale=en-US&page=1"]},"from":{"type":"integer","examples":[1]},"next_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/headcount/location/{location}/venue?per_page=5&_locale=en-US&page=2"]},"path":{"type":"string","examples":["https://example.rosterfy.com/api/v2/headcount/location/{location}/venue"]},"per_page":{"type":"integer","examples":[5]},"prev_page_url":{"type":["string","null"],"examples":[null]},"to":{"type":"integer","examples":[5]}}},"examples":[[{"current_page":1,"data":[{"object":{"id":1,"headcount_location_id":1,"name":"North Gate","frontend_name":"North Gate","code":"NORTHGATE","is_virtual":0,"description":"<p>Main pedestrian entrance.</p>","is_system":0,"training_ids":[1],"deleted_at":null,"created_at":"2026-06-09T05:36:16.000000Z","updated_at":"2026-06-09T05:36:16.000000Z","uuid":"f64e8d2b-7f0d-42fb-91bc-98a098a7f191","address":{"iso":"AUS","region_code":"Example Region","coordinates":{"latitude":null,"longitude":null},"street_address_1":"1 Example Street","street_address_2":null,"street_address_3":null,"city":"Example City","postcode":"1000","region":"Example Region","country":"AU","latitude":null,"longitude":null}},"nice":{"rrn":"rrn:local:20101:venue:1","address":"1 Example Street\nExample City\nExample Region\nAustralia\n1000","address_oneline":"1 Example Street, Example City, Example Region, Australia, 1000","address.country":"Australia","address.country:raw":"AUS","address.city":"Example City","address.region":"Example Region","address.region:raw":"Example Region","address.postcode":"1000","address.street_address_1":"1 Example Street","address.street_address_2":null,"address.street_address_3":null,"address.latitude":null,"address.longitude":null,"location_name":"Main Campus","headcount_location_type_name":"Stadium","headcount_location_type_id":1},"relations":{"location":{"object":{"id":1,"account_id":20101,"headcount_location_type_id":1,"name":"Main Campus","frontend_name":"Main Campus","code":"MAINCAMPUS","training_ids":[1],"is_system":0,"deleted_at":null,"created_at":"2026-06-09T05:36:16.000000Z","updated_at":"2026-06-09T05:36:16.000000Z","uuid":"ec98790e-5bab-4ad7-9357-31556e2efbc4"},"nice":{"rrn":"rrn:local:20101:location:1","headcount_location_type_name":"Stadium"},"permissions":{"read":true,"update":true,"delete":true}}},"permissions":{"read":true,"update":true,"delete":true}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}],"first_page_url":"https://example.rosterfy.com/api/v2/headcount/location/{location}/venue?per_page=5&_locale=en-US&page=1","from":1,"next_page_url":"https://example.rosterfy.com/api/v2/headcount/location/{location}/venue?per_page=5&_locale=en-US&page=2","path":"https://example.rosterfy.com/api/v2/headcount/location/{location}/venue","per_page":5,"prev_page_url":null,"to":5}]]},"id":"schema_352"},"schema_353":{"kind":"json-schema","data":{"type":"object","properties":{"name":{"type":"string","description":"The name administrators see. Required.","examples":["North Gate"]},"frontend_name":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name volunteers see in the portal. Required, and shown in place of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to anyone without administrator access, so it is worth setting even when the two match."},"children":[]}]}]}],"examples":["North Gate"]},"code":{"type":"string","description":"A short reference for the venue. Letters, numbers, commas, dashes and underscores only - spaces and other punctuation are rejected. Accounts configured to require unique venue codes reject a code already in use; otherwise codes may repeat.","examples":["NORTHGATE"]},"training_ids":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The IDs of the training modules assigned to anyone who accepts a role at this venue. "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Replaces the whole list"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rather than adding to it, so send every module you want kept. Omitting the field leaves the stored list untouched."},"children":[]}]}]}],"items":{"type":"integer"},"examples":[[1]]},"is_virtual":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether the venue has no physical address. A virtual venue is excluded from proximity searches and sorts after venues that have coordinates. Setting this on an existing venue "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"detaches the address"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and switching it back off does not restore it - send the address again."},"children":[]}]}]}],"examples":[0]},"address":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Where the venue is, as an address object with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"street_address_1"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"street_address_2"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"street_address_3"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"city"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"region"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"postcode"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and a two-letter "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"country"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Optional even for a venue that is not virtual. On create the address is stored as sent; on update it replaces the address already held. Ignored when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"is_virtual"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is set in the same request."},"children":[]}]}]}],"properties":{},"examples":[{"iso":"AUS","region_code":"Example Region","coordinates":{"latitude":null,"longitude":null},"street_address_1":"1 Example Street","city":"Example City","region":"Example Region","postcode":"1000","country":"AU","latitude":null,"longitude":null}]}},"required":["name","frontend_name","code"]},"id":"schema_353"},"schema_354":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"name":{"type":"string","examples":["North Gate"]},"frontend_name":{"type":"string","examples":["North Gate"]},"code":{"type":"string","examples":["NORTHGATE"]},"training_ids":{"type":"array","items":{"type":"integer"},"examples":[[1]]},"is_virtual":{"type":"integer","examples":[0]},"headcount_location_id":{"type":"integer","examples":[1]},"uuid":{"type":"string","examples":["f64e8d2b-7f0d-42fb-91bc-98a098a7f191"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"created_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"id":{"type":"integer","examples":[1]},"address":{"type":"object","properties":{"iso":{"type":"string","examples":["AUS"]},"region_code":{"type":"string","examples":["Example Region"]},"coordinates":{"type":"object","properties":{"latitude":{"type":["string","null"],"examples":[null]},"longitude":{"type":["string","null"],"examples":[null]}}},"street_address_1":{"type":"string","examples":["1 Example Street"]},"city":{"type":"string","examples":["Example City"]},"region":{"type":"string","examples":["Example Region"]},"postcode":{"type":"string","examples":["1000"]},"country":{"type":"string","examples":["AU"]},"latitude":{"type":["string","null"],"examples":[null]},"longitude":{"type":["string","null"],"examples":[null]}}}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:venue:1"]},"address":{"type":"string","examples":["1 Example Street\nExample City\nExample Region\nAustralia\n1000"]},"address_oneline":{"type":"string","examples":["1 Example Street, Example City, Example Region, Australia, 1000"]},"address.country":{"type":"string","examples":["Australia"]},"address.country:raw":{"type":"string","examples":["AUS"]},"address.city":{"type":"string","examples":["Example City"]},"address.region":{"type":"string","examples":["Example Region"]},"address.region:raw":{"type":"string","examples":["Example Region"]},"address.postcode":{"type":"string","examples":["1000"]},"address.street_address_1":{"type":"string","examples":["1 Example Street"]},"address.street_address_2":{"type":["string","null"],"examples":[null]},"address.street_address_3":{"type":["string","null"],"examples":[null]},"address.latitude":{"type":["string","null"],"examples":[null]},"address.longitude":{"type":["string","null"],"examples":[null]},"location_name":{"type":"string","examples":["Main Campus"]},"headcount_location_type_name":{"type":"string","examples":["Stadium"]},"headcount_location_type_id":{"type":"integer","examples":[1]}}},"relations":{"type":"object","properties":{"location":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"account_id":{"type":"integer","examples":[20101]},"headcount_location_type_id":{"type":"integer","examples":[1]},"name":{"type":"string","examples":["Main Campus"]},"frontend_name":{"type":"string","examples":["Main Campus"]},"code":{"type":"string","examples":["MAINCAMPUS"]},"training_ids":{"type":"array","items":{"type":"integer"},"examples":[[1]]},"is_system":{"type":"integer","examples":[0]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"uuid":{"type":"string","examples":["ec98790e-5bab-4ad7-9357-31556e2efbc4"]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:location:1"]},"headcount_location_type_name":{"type":"string","examples":["Stadium"]}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}}}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}},"examples":[{"object":{"name":"North Gate","frontend_name":"North Gate","code":"NORTHGATE","training_ids":[1],"is_virtual":0,"headcount_location_id":1,"uuid":"f64e8d2b-7f0d-42fb-91bc-98a098a7f191","updated_at":"2026-06-09T05:36:16.000000Z","created_at":"2026-06-09T05:36:16.000000Z","id":1,"address":{"iso":"AUS","region_code":"Example Region","coordinates":{"latitude":null,"longitude":null},"street_address_1":"1 Example Street","city":"Example City","region":"Example Region","postcode":"1000","country":"AU","latitude":null,"longitude":null}},"nice":{"rrn":"rrn:local:20101:venue:1","address":"1 Example Street\nExample City\nExample Region\nAustralia\n1000","address_oneline":"1 Example Street, Example City, Example Region, Australia, 1000","address.country":"Australia","address.country:raw":"AUS","address.city":"Example City","address.region":"Example Region","address.region:raw":"Example Region","address.postcode":"1000","address.street_address_1":"1 Example Street","address.street_address_2":null,"address.street_address_3":null,"address.latitude":null,"address.longitude":null,"location_name":"Main Campus","headcount_location_type_name":"Stadium","headcount_location_type_id":1},"relations":{"location":{"object":{"id":1,"account_id":20101,"headcount_location_type_id":1,"name":"Main Campus","frontend_name":"Main Campus","code":"MAINCAMPUS","training_ids":[1],"is_system":0,"deleted_at":null,"created_at":"2026-06-09T05:36:16.000000Z","updated_at":"2026-06-09T05:36:16.000000Z","uuid":"ec98790e-5bab-4ad7-9357-31556e2efbc4"},"nice":{"rrn":"rrn:local:20101:location:1","headcount_location_type_name":"Stadium"},"permissions":{"read":true,"update":true,"delete":true}}},"permissions":{"read":true,"update":true,"delete":true}}]},"id":"schema_354"},"schema_355":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"headcount_location_id":{"type":"integer","examples":[1]},"name":{"type":"string","examples":["North Gate"]},"frontend_name":{"type":"string","examples":["North Gate"]},"code":{"type":"string","examples":["NORTHGATE"]},"is_virtual":{"type":"integer","examples":[0]},"description":{"type":"string","examples":["<p>Main pedestrian entrance.</p>"]},"is_system":{"type":"integer","examples":[0]},"training_ids":{"type":"array","items":{"type":"integer"},"examples":[[1]]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"uuid":{"type":"string","examples":["f64e8d2b-7f0d-42fb-91bc-98a098a7f191"]},"address":{"type":"object","properties":{"iso":{"type":"string","examples":["AUS"]},"region_code":{"type":"string","examples":["Example Region"]},"coordinates":{"type":"object","properties":{"latitude":{"type":["string","null"],"examples":[null]},"longitude":{"type":["string","null"],"examples":[null]}}},"street_address_1":{"type":"string","examples":["1 Example Street"]},"street_address_2":{"type":["string","null"],"examples":[null]},"street_address_3":{"type":["string","null"],"examples":[null]},"city":{"type":"string","examples":["Example City"]},"postcode":{"type":"string","examples":["1000"]},"region":{"type":"string","examples":["Example Region"]},"country":{"type":"string","examples":["AU"]},"latitude":{"type":["string","null"],"examples":[null]},"longitude":{"type":["string","null"],"examples":[null]}}}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:venue:1"]},"address":{"type":"string","examples":["1 Example Street\nExample City\nExample Region\nAustralia\n1000"]},"address_oneline":{"type":"string","examples":["1 Example Street, Example City, Example Region, Australia, 1000"]},"address.country":{"type":"string","examples":["Australia"]},"address.country:raw":{"type":"string","examples":["AUS"]},"address.city":{"type":"string","examples":["Example City"]},"address.region":{"type":"string","examples":["Example Region"]},"address.region:raw":{"type":"string","examples":["Example Region"]},"address.postcode":{"type":"string","examples":["1000"]},"address.street_address_1":{"type":"string","examples":["1 Example Street"]},"address.street_address_2":{"type":["string","null"],"examples":[null]},"address.street_address_3":{"type":["string","null"],"examples":[null]},"address.latitude":{"type":["string","null"],"examples":[null]},"address.longitude":{"type":["string","null"],"examples":[null]},"location_name":{"type":"string","examples":["Main Campus"]},"headcount_location_type_name":{"type":"string","examples":["Stadium"]},"headcount_location_type_id":{"type":"integer","examples":[1]}}},"relations":{"type":"object","properties":{"location":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"account_id":{"type":"integer","examples":[20101]},"headcount_location_type_id":{"type":"integer","examples":[1]},"name":{"type":"string","examples":["Main Campus"]},"frontend_name":{"type":"string","examples":["Main Campus"]},"code":{"type":"string","examples":["MAINCAMPUS"]},"training_ids":{"type":"array","items":{"type":"integer"},"examples":[[1]]},"is_system":{"type":"integer","examples":[0]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"uuid":{"type":"string","examples":["ec98790e-5bab-4ad7-9357-31556e2efbc4"]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:location:1"]},"headcount_location_type_name":{"type":"string","examples":["Stadium"]}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}}}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}},"examples":[{"object":{"id":1,"headcount_location_id":1,"name":"North Gate","frontend_name":"North Gate","code":"NORTHGATE","is_virtual":0,"description":"<p>Main pedestrian entrance.</p>","is_system":0,"training_ids":[1],"deleted_at":null,"created_at":"2026-06-09T05:36:16.000000Z","updated_at":"2026-06-09T05:36:16.000000Z","uuid":"f64e8d2b-7f0d-42fb-91bc-98a098a7f191","address":{"iso":"AUS","region_code":"Example Region","coordinates":{"latitude":null,"longitude":null},"street_address_1":"1 Example Street","street_address_2":null,"street_address_3":null,"city":"Example City","postcode":"1000","region":"Example Region","country":"AU","latitude":null,"longitude":null}},"nice":{"rrn":"rrn:local:20101:venue:1","address":"1 Example Street\nExample City\nExample Region\nAustralia\n1000","address_oneline":"1 Example Street, Example City, Example Region, Australia, 1000","address.country":"Australia","address.country:raw":"AUS","address.city":"Example City","address.region":"Example Region","address.region:raw":"Example Region","address.postcode":"1000","address.street_address_1":"1 Example Street","address.street_address_2":null,"address.street_address_3":null,"address.latitude":null,"address.longitude":null,"location_name":"Main Campus","headcount_location_type_name":"Stadium","headcount_location_type_id":1},"relations":{"location":{"object":{"id":1,"account_id":20101,"headcount_location_type_id":1,"name":"Main Campus","frontend_name":"Main Campus","code":"MAINCAMPUS","training_ids":[1],"is_system":0,"deleted_at":null,"created_at":"2026-06-09T05:36:16.000000Z","updated_at":"2026-06-09T05:36:16.000000Z","uuid":"ec98790e-5bab-4ad7-9357-31556e2efbc4"},"nice":{"rrn":"rrn:local:20101:location:1","headcount_location_type_name":"Stadium"},"permissions":{"read":true,"update":true,"delete":true}}},"permissions":{"read":true,"update":true,"delete":true}}]},"id":"schema_355"},"schema_356":{"kind":"json-schema","data":{"type":"object","properties":{"name":{"type":"string","description":"The name administrators see. Required.","examples":["North Gate"]},"frontend_name":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name volunteers see in the portal. Required, and shown in place of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to anyone without administrator access, so it is worth setting even when the two match."},"children":[]}]}]}],"examples":["North Gate"]},"code":{"type":"string","description":"A short reference for the venue. Letters, numbers, commas, dashes and underscores only - spaces and other punctuation are rejected. Accounts configured to require unique venue codes reject a code already in use; otherwise codes may repeat.","examples":["NORTHGATE"]},"training_ids":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The IDs of the training modules assigned to anyone who accepts a role at this venue. "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Replaces the whole list"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rather than adding to it, so send every module you want kept. Omitting the field leaves the stored list untouched."},"children":[]}]}]}],"items":{"type":"integer"},"examples":[[1]]},"is_virtual":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether the venue has no physical address. A virtual venue is excluded from proximity searches and sorts after venues that have coordinates. Setting this on an existing venue "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"detaches the address"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and switching it back off does not restore it - send the address again."},"children":[]}]}]}],"examples":[0]},"description":{"type":"string","description":"A description of the venue, in HTML. Shown to volunteers alongside the venue name.","examples":["<p>Main pedestrian entrance.</p>"]},"address":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Where the venue is, as an address object with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"street_address_1"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"street_address_2"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"street_address_3"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"city"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"region"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"postcode"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and a two-letter "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"country"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Optional even for a venue that is not virtual. On create the address is stored as sent; on update it replaces the address already held. Ignored when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"is_virtual"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is set in the same request."},"children":[]}]}]}],"properties":{},"examples":[{"iso":"AUS","region_code":"Example Region","coordinates":{"latitude":null,"longitude":null},"street_address_1":"1 Example Street","street_address_2":null,"street_address_3":null,"city":"Example City","postcode":"1000","region":"Example Region","country":"AU","latitude":null,"longitude":null}]}}},"id":"schema_356"},"schema_357":{"kind":"json-schema","data":{"type":"array","items":{"type":"object","properties":{"current_page":{"type":"integer","examples":[1]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"name":{"type":"string","examples":["Stadium"]},"sort_order":{"type":"integer","examples":[1]},"uuid":{"type":"string","examples":["bf46e175-87a9-4968-8e58-21efec6873a2"]}}},"nice":{"type":"array","examples":[[]]},"relations":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}}},"examples":[[{"object":{"id":1,"name":"Stadium","sort_order":1,"uuid":"bf46e175-87a9-4968-8e58-21efec6873a2"},"nice":[],"relations":[],"permissions":{"read":true,"update":true,"delete":true}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}]]},"first_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/headcount/location/type?per_page=5&_locale=en-US&page=1"]},"from":{"type":"integer","examples":[1]},"next_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/headcount/location/type?per_page=5&_locale=en-US&page=2"]},"path":{"type":"string","examples":["https://example.rosterfy.com/api/v2/headcount/location/type"]},"per_page":{"type":"integer","examples":[5]},"prev_page_url":{"type":["string","null"],"examples":[null]},"to":{"type":"integer","examples":[5]}}},"examples":[[{"current_page":1,"data":[{"object":{"id":1,"name":"Stadium","sort_order":1,"uuid":"bf46e175-87a9-4968-8e58-21efec6873a2"},"nice":[],"relations":[],"permissions":{"read":true,"update":true,"delete":true}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}],"first_page_url":"https://example.rosterfy.com/api/v2/headcount/location/type?per_page=5&_locale=en-US&page=1","from":1,"next_page_url":"https://example.rosterfy.com/api/v2/headcount/location/type?per_page=5&_locale=en-US&page=2","path":"https://example.rosterfy.com/api/v2/headcount/location/type","per_page":5,"prev_page_url":null,"to":5}]]},"id":"schema_357"},"schema_358":{"kind":"json-schema","data":{"type":"object","properties":{"name":{"type":"string","description":"The name of the location type. Required.","examples":["Stadium"]},"sort_order":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Where this type sits in the list, lowest first. Optional; types created without one sort as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[1]}},"required":["name"]},"id":"schema_358"},"schema_359":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"name":{"type":"string","examples":["Stadium"]},"sort_order":{"type":"integer","examples":[1]},"uuid":{"type":"string","examples":["bf46e175-87a9-4968-8e58-21efec6873a2"]}}},"nice":{"type":"array","examples":[[]]},"relations":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}},"examples":[{"object":{"id":1,"name":"Stadium","sort_order":1,"uuid":"bf46e175-87a9-4968-8e58-21efec6873a2"},"nice":[],"relations":[],"permissions":{"read":true,"update":true,"delete":true}}]},"id":"schema_359"},"schema_360":{"kind":"json-schema","data":{"type":"object","properties":{"name":{"type":"string","description":"The name of the location type. Required.","examples":["Stadium"]},"sort_order":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Where this type sits in the list, lowest first. Optional; types created without one sort as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[1]}}},"id":"schema_360"},"schema_361":{"kind":"json-schema","data":{"type":"array","description":"A list of extras to include in the response. These are objects or arrays that are not part of\nthe model's primary attributes, such as stats and counts.\nFor fast responses, avoid requesting them if you don't need them. ","items":{"type":"string","enum":["stats","variations"]},"examples":[["stats"]]},"id":"schema_361"},"schema_362":{"kind":"json-schema","data":{"type":"array","items":{"type":"object","properties":{"current_page":{"type":"integer","examples":[1]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"parent_id":{"type":["string","null"],"examples":[null]},"type":{"type":"string","examples":["distributable"]},"external_id":{"type":"string","examples":["SKU-10023"]},"certificate_id":{"type":["string","null"],"examples":[null]},"is_image":{"type":"integer","examples":[0]},"icon":{"type":"string","examples":["fab fa-accusoft"]},"variation_config":{"type":["string","null"],"examples":[null]},"has_quantity":{"type":"integer","examples":[1]},"quantity":{"type":"integer","examples":[54]},"max_per_user":{"type":"integer","examples":[0]},"has_serial":{"type":"integer","examples":[0]},"category_id":{"type":["string","null"],"examples":[null]},"serial_assignment_mode":{"type":["string","null"],"examples":[null]},"is_distributable":{"type":"integer","examples":[0]},"is_redeemable":{"type":"integer","examples":[0]},"ttl":{"type":["string","null"],"examples":[null]},"reward_point_cost":{"type":"integer","examples":[0]},"budget_cost":{"type":"string","examples":["0.00"]},"publish":{"type":"integer","examples":[1]},"sort_order":{"type":"integer","examples":[0]},"has_variants":{"type":"integer","examples":[0]},"varied_by_attribute_id":{"type":["string","null"],"examples":[null]},"variant_source_id":{"type":["string","null"],"examples":[null]},"is_archived":{"type":"integer","examples":[0]},"is_distributable_at_checkin_checkout":{"type":["string","null"],"examples":[null]},"deleted_at":{"type":["string","null"],"examples":[null]},"is_erased":{"type":"integer","examples":[0]},"created_at":{"type":"string","examples":["2026-06-09T05:36:26.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:26.000000Z"]},"deleted_by":{"type":["string","null"],"examples":[null]},"is_inheritable":{"type":"integer","examples":[0]},"name":{"type":"string","examples":["Volunteer T-Shirt"]}}},"nice":{"type":"object","properties":{"created_at":{"type":"string","examples":["Jun 9, 2026, 5:36 AM"]},"created_at__date":{"type":"string","examples":["Jun 9, 2026"]},"created_at__time":{"type":"string","examples":["5:36 AM"]},"created_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"created_at__offset_minutes":{"type":"integer","examples":[0]},"created_at__dayofweek":{"type":"string","examples":["Tuesday"]},"external_id":{"type":"string","examples":["SKU-10023"]},"has_quantity":{"type":"string","examples":["Yes"]},"has_variants":{"type":"string","examples":["No"]},"is_distributable_at_checkin_checkout":{"type":"string","examples":["No"]},"name":{"type":"string","examples":["Volunteer T-Shirt"]},"publish":{"type":"string","examples":["Yes"]},"type":{"type":"string","examples":["Distributable"]},"type:value":{"type":"string","examples":["distributable"]},"type:array":{"type":"string","examples":["Distributable"]},"updated_at":{"type":"string","examples":["Jun 9, 2026, 5:36 AM"]},"updated_at__date":{"type":"string","examples":["Jun 9, 2026"]},"updated_at__time":{"type":"string","examples":["5:36 AM"]},"updated_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"updated_at__offset_minutes":{"type":"integer","examples":[0]},"updated_at__dayofweek":{"type":"string","examples":["Tuesday"]},"distributed":{"type":"integer","examples":[1]},"allocated":{"type":"integer","examples":[0]},"available":{"type":"integer","examples":[53]},"stock_level":{"type":"string","examples":["98%"]},"manual_serial_required":{"type":"boolean","examples":[false]},"account_name_path":{"type":"string","examples":["Rosterfy Subaccount"]},"is_foreign_account":{"type":"boolean","examples":[false]}}},"relations":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]},"redeem":{"type":"boolean","examples":[true]}}},"attributes":{"type":"array","examples":[[]]}}},"examples":[[{"object":{"id":1,"parent_id":null,"type":"distributable","external_id":"SKU-10023","certificate_id":null,"is_image":0,"icon":"fab fa-accusoft","variation_config":null,"has_quantity":1,"quantity":54,"max_per_user":0,"has_serial":0,"category_id":null,"serial_assignment_mode":null,"is_distributable":0,"is_redeemable":0,"ttl":null,"reward_point_cost":0,"budget_cost":"0.00","publish":1,"sort_order":0,"has_variants":0,"varied_by_attribute_id":null,"variant_source_id":null,"is_archived":0,"is_distributable_at_checkin_checkout":null,"deleted_at":null,"is_erased":0,"created_at":"2026-06-09T05:36:26.000000Z","updated_at":"2026-06-09T05:36:26.000000Z","deleted_by":null,"is_inheritable":0,"name":"Volunteer T-Shirt"},"nice":{"created_at":"Jun 9, 2026, 5:36 AM","created_at__date":"Jun 9, 2026","created_at__time":"5:36 AM","created_at__offset":" (+00:00 UTC)","created_at__offset_minutes":0,"created_at__dayofweek":"Tuesday","external_id":"SKU-10023","has_quantity":"Yes","has_variants":"No","is_distributable_at_checkin_checkout":"No","name":"Volunteer T-Shirt","publish":"Yes","type":"Distributable","type:value":"distributable","type:array":"Distributable","updated_at":"Jun 9, 2026, 5:36 AM","updated_at__date":"Jun 9, 2026","updated_at__time":"5:36 AM","updated_at__offset":" (+00:00 UTC)","updated_at__offset_minutes":0,"updated_at__dayofweek":"Tuesday","distributed":1,"allocated":0,"available":53,"stock_level":"98%","manual_serial_required":false,"account_name_path":"Rosterfy Subaccount","is_foreign_account":false},"relations":[],"permissions":{"read":true,"update":true,"delete":true,"redeem":true},"attributes":[]},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}]]},"first_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/inventory/item?per_page=5&_locale=en-US&page=1"]},"from":{"type":"integer","examples":[1]},"next_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/inventory/item?per_page=5&_locale=en-US&page=2"]},"path":{"type":"string","examples":["https://example.rosterfy.com/api/v2/inventory/item"]},"per_page":{"type":"integer","examples":[5]},"prev_page_url":{"type":["string","null"],"examples":[null]},"to":{"type":"integer","examples":[5]}}},"examples":[[{"current_page":1,"data":[{"object":{"id":1,"parent_id":null,"type":"distributable","external_id":"SKU-10023","certificate_id":null,"is_image":0,"icon":"fab fa-accusoft","variation_config":null,"has_quantity":1,"quantity":54,"max_per_user":0,"has_serial":0,"category_id":null,"serial_assignment_mode":null,"is_distributable":0,"is_redeemable":0,"ttl":null,"reward_point_cost":0,"budget_cost":"0.00","publish":1,"sort_order":0,"has_variants":0,"varied_by_attribute_id":null,"variant_source_id":null,"is_archived":0,"is_distributable_at_checkin_checkout":null,"deleted_at":null,"is_erased":0,"created_at":"2026-06-09T05:36:26.000000Z","updated_at":"2026-06-09T05:36:26.000000Z","deleted_by":null,"is_inheritable":0,"name":"Volunteer T-Shirt"},"nice":{"created_at":"Jun 9, 2026, 5:36 AM","created_at__date":"Jun 9, 2026","created_at__time":"5:36 AM","created_at__offset":" (+00:00 UTC)","created_at__offset_minutes":0,"created_at__dayofweek":"Tuesday","external_id":"SKU-10023","has_quantity":"Yes","has_variants":"No","is_distributable_at_checkin_checkout":"No","name":"Volunteer T-Shirt","publish":"Yes","type":"Distributable","type:value":"distributable","type:array":"Distributable","updated_at":"Jun 9, 2026, 5:36 AM","updated_at__date":"Jun 9, 2026","updated_at__time":"5:36 AM","updated_at__offset":" (+00:00 UTC)","updated_at__offset_minutes":0,"updated_at__dayofweek":"Tuesday","distributed":1,"allocated":0,"available":53,"stock_level":"98%","manual_serial_required":false,"account_name_path":"Rosterfy Subaccount","is_foreign_account":false},"relations":[],"permissions":{"read":true,"update":true,"delete":true,"redeem":true},"attributes":[]},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}],"first_page_url":"https://example.rosterfy.com/api/v2/inventory/item?per_page=5&_locale=en-US&page=1","from":1,"next_page_url":"https://example.rosterfy.com/api/v2/inventory/item?per_page=5&_locale=en-US&page=2","path":"https://example.rosterfy.com/api/v2/inventory/item","per_page":5,"prev_page_url":null,"to":5}]]},"id":"schema_362"},"schema_363":{"kind":"json-schema","data":{"type":"object","properties":{"name":{"type":"string","description":"The name of the item, as it appears to administrators and to volunteers choosing a reward. Required, and limited to 255 characters.","examples":["Volunteer T-Shirt"]},"type":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"What kind of item this is. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"distributable"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a physical item handed out and tracked per person, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"virtual"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is issued without stock, and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"certificate"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issues a certificate on allocation. Required, and it determines which of the other fields apply."},"children":[]}]}]}],"examples":["distributable"]},"external_id":{"type":"string","description":"Your own reference for the item - a SKU or catalogue code. Not used by Rosterfy for anything; it exists so you can match an item back to your own system.","examples":["SKU-10023"]},"parent_id":{"type":"integer","description":"The ID of the item this one is a variant of. Set only on variant items.","examples":[1]},"certificate_id":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the certificate template to issue when the item is allocated. Applies to items of type "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"certificate"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[1]},"category_id":{"type":"integer","description":"The ID of the category the item is filed under.","examples":[1]},"icon":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The icon shown against the item. Either an icon class name, or an image URL when is_image is set. See file_path for uploading an image instead."},"children":[]}]}]}],"examples":["fas fa-shirt"]},"is_image":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether the item is shown with an uploaded image rather than an icon. When set, supply the image through file_path."},"children":[]}]}]}],"examples":[true]},"file_path":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The image to show against the item, used only when is_image is set. Send either a URL to an existing image, or the image itself as a file - see the endpoint description for how to send a file. The value is not stored as sent; it is resolved and the result is stored on icon."},"children":[]}]}]}],"examples":[null]},"has_quantity":{"type":"boolean","description":"Whether stock is tracked for this item. When set, quantity must be given and must be greater than 0. When not set, quantity is reset to 0.","examples":[1]},"quantity":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How many of the item are in stock. Only accepted when has_quantity is set, and must be greater than 0."},"children":[]}]}]}],"examples":[250]},"max_per_user":{"type":"integer","description":"The most of this item any one person may hold at once. 0 means no limit. Cannot be negative. An allocation that would exceed it is rejected unless the request overrides the limit.","examples":[1]},"has_serial":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether individual units carry serial numbers. When set, serial_assignment_mode must be given. When not set, serial_assignment_mode is reset to null."},"children":[]}]}]}],"examples":[true]},"serial_assignment_mode":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How a serial is chosen when the item is allocated: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"auto"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" takes the next free serial, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"manual"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" requires the serial to be named on the allocation. Only accepted when has_serial is set."},"children":[]}]}]}],"examples":[null]},"is_redeemable":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether volunteers can redeem this item with reward points. When set, reward_point_cost must be given. When not set, reward_point_cost is reset to 0."},"children":[]}]}]}],"examples":[true]},"reward_point_cost":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How many reward points redeeming the item costs. Only accepted when is_redeemable is set, and must be greater than 0."},"children":[]}]}]}],"examples":[0]},"has_expiry":{"type":"boolean","description":"Whether an allocation of this item expires. When set, ttl must be given. When not set, ttl is reset to null. Not stored on the item itself - it is the switch that decides whether ttl is accepted.","examples":[true]},"ttl":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How long an allocation of this item stays valid, in seconds. Used to work out the expiry date when the item is given to someone. Only accepted when has_expiry is set; when has_expiry is not set it is reset to null."},"children":[]}]}]}],"examples":[1]},"budget_cost":{"type":"number","description":"The unit cost of the item, used in budget reporting. Two decimal places.","examples":[1.23]},"publish":{"type":"boolean","description":"Whether the item is live. An unpublished item cannot be collected and is not offered to volunteers.","examples":[1]},"is_archived":{"type":"boolean","description":"Whether the item is archived. An archived item is kept for reporting but is no longer offered.","examples":[true]},"is_inheritable":{"type":"boolean","description":"Whether subaccounts of this account can use the item.","examples":[true]},"is_distributable_at_checkin_checkout":{"type":"boolean","description":"Whether the item can be handed out as part of checking a volunteer in or out of a shift.","examples":[true]},"has_variants":{"type":"boolean","description":"Whether this item is a parent that holds variants, such as a garment held in several sizes.","examples":[true]},"varied_by_attribute_id":{"type":"integer","description":"The ID of the attribute the variants differ by, such as size. Set on a parent item.","examples":[1]},"variant_source_id":{"type":"integer","description":"The ID of the option, within the varying attribute, that this variant represents. Set on a variant item.","examples":[1]},"variation_config":{"type":"object","description":"The variant configuration for a parent item.","properties":{},"examples":["{}"]},"sort_order":{"type":"integer","description":"Where the item sits in lists. Lower sorts first.","examples":[1]},"custom_*":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A custom attribute, named by its code - custom_shirt_size, for example. The value follows the attribute's own type, so it may be a string, a number, a boolean or a list. See the custom attributes documentation."},"children":[]}]}]}],"examples":[null]}},"required":["name","type"]},"id":"schema_363"},"schema_364":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"name":{"type":"string","examples":["Volunteer T-Shirt"]},"type":{"type":"string","examples":["distributable"]},"publish":{"type":"integer","examples":[1]},"icon":{"type":"string","examples":["fas fa-shirt"]},"external_id":{"type":"string","examples":["SKU-10023"]},"has_quantity":{"type":"integer","examples":[1]},"quantity":{"type":"integer","examples":[250]},"max_per_user":{"type":"integer","examples":[1]},"ttl":{"type":["string","null"],"examples":[null]},"reward_point_cost":{"type":"integer","examples":[0]},"serial_assignment_mode":{"type":["string","null"],"examples":[null]},"varied_by_attribute_id":{"type":["string","null"],"examples":[null]},"updated_at":{"type":"string","examples":["2026-08-06T02:15:55.000000Z"]},"created_at":{"type":"string","examples":["2026-08-06T02:15:55.000000Z"]},"id":{"type":"integer","examples":[34]}}},"nice":{"type":"object","properties":{"created_at":{"type":"string","examples":["Aug 6, 2026, 2:15 AM"]},"created_at__date":{"type":"string","examples":["Aug 6, 2026"]},"created_at__time":{"type":"string","examples":["2:15 AM"]},"created_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"created_at__offset_minutes":{"type":"integer","examples":[0]},"created_at__dayofweek":{"type":"string","examples":["Thursday"]},"external_id":{"type":"string","examples":["SKU-10023"]},"has_quantity":{"type":"string","examples":["Yes"]},"has_variants":{"type":"string","examples":["No"]},"is_distributable_at_checkin_checkout":{"type":"string","examples":["No"]},"name":{"type":"string","examples":["Volunteer T-Shirt"]},"publish":{"type":"string","examples":["Yes"]},"type":{"type":"string","examples":["Distributable"]},"type:value":{"type":"string","examples":["distributable"]},"type:array":{"type":"string","examples":["Distributable"]},"updated_at":{"type":"string","examples":["Aug 6, 2026, 2:15 AM"]},"updated_at__date":{"type":"string","examples":["Aug 6, 2026"]},"updated_at__time":{"type":"string","examples":["2:15 AM"]},"updated_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"updated_at__offset_minutes":{"type":"integer","examples":[0]},"updated_at__dayofweek":{"type":"string","examples":["Thursday"]},"distributed":{"type":"integer","examples":[0]},"allocated":{"type":"integer","examples":[0]},"available":{"type":"integer","examples":[250]},"stock_level":{"type":"string","examples":["100%"]},"manual_serial_required":{"type":"boolean","examples":[false]},"account_name_path":{"type":"string","examples":["Rosterfy Subaccount"]},"is_foreign_account":{"type":"boolean","examples":[false]}}},"relations":{"type":"object","properties":{}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]},"redeem":{"type":"boolean","examples":[true]}}},"attributes":{"type":"object","properties":{}}},"examples":[{"object":{"name":"Volunteer T-Shirt","type":"distributable","publish":1,"icon":"fas fa-shirt","external_id":"SKU-10023","has_quantity":1,"quantity":250,"max_per_user":1,"ttl":null,"reward_point_cost":0,"serial_assignment_mode":null,"varied_by_attribute_id":null,"updated_at":"2026-08-06T02:15:55.000000Z","created_at":"2026-08-06T02:15:55.000000Z","id":34},"nice":{"created_at":"Aug 6, 2026, 2:15 AM","created_at__date":"Aug 6, 2026","created_at__time":"2:15 AM","created_at__offset":" (+00:00 UTC)","created_at__offset_minutes":0,"created_at__dayofweek":"Thursday","external_id":"SKU-10023","has_quantity":"Yes","has_variants":"No","is_distributable_at_checkin_checkout":"No","name":"Volunteer T-Shirt","publish":"Yes","type":"Distributable","type:value":"distributable","type:array":"Distributable","updated_at":"Aug 6, 2026, 2:15 AM","updated_at__date":"Aug 6, 2026","updated_at__time":"2:15 AM","updated_at__offset":" (+00:00 UTC)","updated_at__offset_minutes":0,"updated_at__dayofweek":"Thursday","distributed":0,"allocated":0,"available":250,"stock_level":"100%","manual_serial_required":false,"account_name_path":"Rosterfy Subaccount","is_foreign_account":false},"relations":{},"permissions":{"read":true,"update":true,"delete":true,"redeem":true},"attributes":{}}]},"id":"schema_364"},"schema_365":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"parent_id":{"type":["string","null"],"examples":[null]},"type":{"type":"string","examples":["distributable"]},"external_id":{"type":"string","examples":["SKU-10023"]},"certificate_id":{"type":["string","null"],"examples":[null]},"is_image":{"type":"integer","examples":[0]},"icon":{"type":"string","examples":["fab fa-accusoft"]},"variation_config":{"type":["string","null"],"examples":[null]},"has_quantity":{"type":"integer","examples":[1]},"quantity":{"type":"integer","examples":[54]},"max_per_user":{"type":"integer","examples":[0]},"has_serial":{"type":"integer","examples":[0]},"category_id":{"type":["string","null"],"examples":[null]},"serial_assignment_mode":{"type":["string","null"],"examples":[null]},"is_distributable":{"type":"integer","examples":[0]},"is_redeemable":{"type":"integer","examples":[0]},"ttl":{"type":["string","null"],"examples":[null]},"reward_point_cost":{"type":"integer","examples":[0]},"budget_cost":{"type":"string","examples":["0.00"]},"publish":{"type":"integer","examples":[1]},"sort_order":{"type":"integer","examples":[0]},"has_variants":{"type":"integer","examples":[0]},"varied_by_attribute_id":{"type":["string","null"],"examples":[null]},"variant_source_id":{"type":["string","null"],"examples":[null]},"is_archived":{"type":"integer","examples":[0]},"is_distributable_at_checkin_checkout":{"type":["string","null"],"examples":[null]},"deleted_at":{"type":["string","null"],"examples":[null]},"is_erased":{"type":"integer","examples":[0]},"created_at":{"type":"string","examples":["2026-06-09T05:36:26.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:26.000000Z"]},"deleted_by":{"type":["string","null"],"examples":[null]},"is_inheritable":{"type":"integer","examples":[0]},"name":{"type":"string","examples":["Volunteer T-Shirt"]}}},"nice":{"type":"object","properties":{"created_at":{"type":"string","examples":["Jun 9, 2026, 5:36 AM"]},"created_at__date":{"type":"string","examples":["Jun 9, 2026"]},"created_at__time":{"type":"string","examples":["5:36 AM"]},"created_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"created_at__offset_minutes":{"type":"integer","examples":[0]},"created_at__dayofweek":{"type":"string","examples":["Tuesday"]},"external_id":{"type":"string","examples":["SKU-10023"]},"has_quantity":{"type":"string","examples":["Yes"]},"has_variants":{"type":"string","examples":["No"]},"is_distributable_at_checkin_checkout":{"type":"string","examples":["No"]},"name":{"type":"string","examples":["Volunteer T-Shirt"]},"publish":{"type":"string","examples":["Yes"]},"type":{"type":"string","examples":["Distributable"]},"type:value":{"type":"string","examples":["distributable"]},"type:array":{"type":"string","examples":["Distributable"]},"updated_at":{"type":"string","examples":["Jun 9, 2026, 5:36 AM"]},"updated_at__date":{"type":"string","examples":["Jun 9, 2026"]},"updated_at__time":{"type":"string","examples":["5:36 AM"]},"updated_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"updated_at__offset_minutes":{"type":"integer","examples":[0]},"updated_at__dayofweek":{"type":"string","examples":["Tuesday"]},"distributed":{"type":"integer","examples":[1]},"allocated":{"type":"integer","examples":[0]},"available":{"type":"integer","examples":[53]},"stock_level":{"type":"string","examples":["98%"]},"manual_serial_required":{"type":"boolean","examples":[false]},"account_name_path":{"type":"string","examples":["Rosterfy Subaccount"]},"is_foreign_account":{"type":"boolean","examples":[false]}}},"relations":{"type":"object","properties":{}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]},"redeem":{"type":"boolean","examples":[true]}}},"attributes":{"type":"object","properties":{}}},"examples":[{"object":{"id":1,"parent_id":null,"type":"distributable","external_id":"SKU-10023","certificate_id":null,"is_image":0,"icon":"fab fa-accusoft","variation_config":null,"has_quantity":1,"quantity":54,"max_per_user":0,"has_serial":0,"category_id":null,"serial_assignment_mode":null,"is_distributable":0,"is_redeemable":0,"ttl":null,"reward_point_cost":0,"budget_cost":"0.00","publish":1,"sort_order":0,"has_variants":0,"varied_by_attribute_id":null,"variant_source_id":null,"is_archived":0,"is_distributable_at_checkin_checkout":null,"deleted_at":null,"is_erased":0,"created_at":"2026-06-09T05:36:26.000000Z","updated_at":"2026-06-09T05:36:26.000000Z","deleted_by":null,"is_inheritable":0,"name":"Volunteer T-Shirt"},"nice":{"created_at":"Jun 9, 2026, 5:36 AM","created_at__date":"Jun 9, 2026","created_at__time":"5:36 AM","created_at__offset":" (+00:00 UTC)","created_at__offset_minutes":0,"created_at__dayofweek":"Tuesday","external_id":"SKU-10023","has_quantity":"Yes","has_variants":"No","is_distributable_at_checkin_checkout":"No","name":"Volunteer T-Shirt","publish":"Yes","type":"Distributable","type:value":"distributable","type:array":"Distributable","updated_at":"Jun 9, 2026, 5:36 AM","updated_at__date":"Jun 9, 2026","updated_at__time":"5:36 AM","updated_at__offset":" (+00:00 UTC)","updated_at__offset_minutes":0,"updated_at__dayofweek":"Tuesday","distributed":1,"allocated":0,"available":53,"stock_level":"98%","manual_serial_required":false,"account_name_path":"Rosterfy Subaccount","is_foreign_account":false},"relations":{},"permissions":{"read":true,"update":true,"delete":true,"redeem":true},"attributes":{}}]},"id":"schema_365"},"schema_366":{"kind":"json-schema","data":{"type":"object","properties":{"name":{"type":"string","description":"The name of the item, as it appears to administrators and to volunteers choosing a reward. Required, and limited to 255 characters.","examples":["Volunteer T-Shirt"]},"type":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"What kind of item this is. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"distributable"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a physical item handed out and tracked per person, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"virtual"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is issued without stock, and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"certificate"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issues a certificate on allocation. Required, and it determines which of the other fields apply."},"children":[]}]}]}],"examples":["distributable"]},"external_id":{"type":"string","description":"Your own reference for the item - a SKU or catalogue code. Not used by Rosterfy for anything; it exists so you can match an item back to your own system.","examples":["SKU-10023"]},"parent_id":{"type":"integer","description":"The ID of the item this one is a variant of. Set only on variant items.","examples":[1]},"certificate_id":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the certificate template to issue when the item is allocated. Applies to items of type "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"certificate"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[1]},"category_id":{"type":"integer","description":"The ID of the category the item is filed under.","examples":[1]},"icon":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The icon shown against the item. Either an icon class name, or an image URL when is_image is set. See file_path for uploading an image instead."},"children":[]}]}]}],"examples":["fab fa-accusoft"]},"is_image":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether the item is shown with an uploaded image rather than an icon. When set, supply the image through file_path."},"children":[]}]}]}],"examples":[0]},"file_path":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The image to show against the item, used only when is_image is set. Send either a URL to an existing image, or the image itself as a file - see the endpoint description for how to send a file. The value is not stored as sent; it is resolved and the result is stored on icon."},"children":[]}]}]}],"examples":[null]},"has_quantity":{"type":"boolean","description":"Whether stock is tracked for this item. When set, quantity must be given and must be greater than 0. When not set, quantity is reset to 0.","examples":[1]},"quantity":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How many of the item are in stock. Only accepted when has_quantity is set, and must be greater than 0."},"children":[]}]}]}],"examples":[54]},"max_per_user":{"type":"integer","description":"The most of this item any one person may hold at once. 0 means no limit. Cannot be negative. An allocation that would exceed it is rejected unless the request overrides the limit.","examples":[0]},"has_serial":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether individual units carry serial numbers. When set, serial_assignment_mode must be given. When not set, serial_assignment_mode is reset to null."},"children":[]}]}]}],"examples":[0]},"serial_assignment_mode":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How a serial is chosen when the item is allocated: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"auto"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" takes the next free serial, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"manual"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" requires the serial to be named on the allocation. Only accepted when has_serial is set."},"children":[]}]}]}],"examples":[null]},"is_redeemable":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether volunteers can redeem this item with reward points. When set, reward_point_cost must be given. When not set, reward_point_cost is reset to 0."},"children":[]}]}]}],"examples":[0]},"reward_point_cost":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How many reward points redeeming the item costs. Only accepted when is_redeemable is set, and must be greater than 0."},"children":[]}]}]}],"examples":[0]},"has_expiry":{"type":"boolean","description":"Whether an allocation of this item expires. When set, ttl must be given. When not set, ttl is reset to null. Not stored on the item itself - it is the switch that decides whether ttl is accepted.","examples":[true]},"ttl":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How long an allocation of this item stays valid, in seconds. Used to work out the expiry date when the item is given to someone. Only accepted when has_expiry is set; when has_expiry is not set it is reset to null."},"children":[]}]}]}],"examples":[1]},"budget_cost":{"type":"number","description":"The unit cost of the item, used in budget reporting. Two decimal places.","examples":["0.00"]},"publish":{"type":"boolean","description":"Whether the item is live. An unpublished item cannot be collected and is not offered to volunteers.","examples":[1]},"is_archived":{"type":"boolean","description":"Whether the item is archived. An archived item is kept for reporting but is no longer offered.","examples":[0]},"is_inheritable":{"type":"boolean","description":"Whether subaccounts of this account can use the item.","examples":[0]},"is_distributable_at_checkin_checkout":{"type":"boolean","description":"Whether the item can be handed out as part of checking a volunteer in or out of a shift.","examples":[true]},"has_variants":{"type":"boolean","description":"Whether this item is a parent that holds variants, such as a garment held in several sizes.","examples":[0]},"varied_by_attribute_id":{"type":"integer","description":"The ID of the attribute the variants differ by, such as size. Set on a parent item.","examples":[1]},"variant_source_id":{"type":"integer","description":"The ID of the option, within the varying attribute, that this variant represents. Set on a variant item.","examples":[1]},"variation_config":{"type":"object","description":"The variant configuration for a parent item.","properties":{},"examples":["{}"]},"sort_order":{"type":"integer","description":"Where the item sits in lists. Lower sorts first.","examples":[0]},"custom_*":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A custom attribute, named by its code - custom_shirt_size, for example. The value follows the attribute's own type, so it may be a string, a number, a boolean or a list. See the custom attributes documentation."},"children":[]}]}]}],"examples":[null]}}},"id":"schema_366"},"schema_367":{"kind":"json-schema","data":{"type":"object","properties":{"user_id":{"type":"integer","description":"The ID of the person the item is allocated to. Required on create.","examples":[1234]},"inventory_allocation_type":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How the person came by the item - for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rewards"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when they redeemed it with points. Recorded against the allocation and used in reporting; it does not change how the allocation behaves."},"children":[]}]}]}],"examples":["rewards"]},"expires_at":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the allocation stops being valid, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD HH:MM:SS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Left unset on create, it is worked out from the item's validity period if it has one."},"children":[]}]}]}],"examples":["2026-06-10T05:36:49.000000Z"]},"collected_at":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the person physically received the item, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD HH:MM:SS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Leave unset for an allocation that has not been handed over yet; an allocation with no collection time is what the collect endpoint acts on."},"children":[]}]}]}],"examples":["2026-06-02T05:29:35.000000Z"]},"ignore_max_per_user":{"type":"boolean","description":"Set to allocate the item even though the person already holds as many as the item permits. Without it, an allocation over that limit is rejected. Accepted on create only.","examples":[true]},"quantity":{"type":"integer","description":"Not stored. The allocation record holds one unit, so this field is accepted and then discarded - allocate the item more than once to give someone several.","examples":[1]}},"required":["user_id"]},"id":"schema_367"},"schema_368":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[11]},"inventory_allocation_id":{"type":["string","null"],"examples":[null]},"inventory_item_id":{"type":"integer","examples":[1]},"user_id":{"type":"integer","examples":[1234]},"entity":{"type":["string","null"],"examples":[null]},"entity_id":{"type":["string","null"],"examples":[null]},"inventory_allocation_type":{"type":"string","examples":["rewards"]},"serial":{"type":["string","null"],"examples":[null]},"inventory_item_serial_id":{"type":["string","null"],"examples":[null]},"expires_at":{"type":"string","examples":["2026-06-10T05:36:49.000000Z"]},"collected_at":{"type":"string","examples":["2026-06-02T05:29:35.000000Z"]},"collected_entity":{"type":["string","null"],"examples":[null]},"collected_by":{"type":["string","null"],"examples":[null]},"data":{"type":["string","null"],"examples":[null]},"sort_order":{"type":"integer","examples":[0]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-06-09T05:36:49.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:49.000000Z"]}}},"nice":{"type":"object","properties":{"inventory_allocation_type":{"type":"string","examples":["Rewards"]},"user_name":{"type":"string","examples":["Alex Example"]}}},"relations":{"type":"object","properties":{"user":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1234]},"first_name":{"type":"string","examples":["Alex"]},"last_name":{"type":"string","examples":["Example"]},"email":{"type":"string","examples":["alex.example@example.com"]}}},"nice":{"type":"object","properties":{"first_name":{"type":"string","examples":["Alex"]},"last_name":{"type":"string","examples":["Example"]}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}},"id":{"type":"integer","examples":[1234]},"name":{"type":"string","examples":["Alex Example"]}}},"inventory_allocation":{"type":["string","null"],"examples":[null]},"inventory_item":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"parent_id":{"type":["string","null"],"examples":[null]},"type":{"type":"string","examples":["distributable"]},"external_id":{"type":"string","examples":["SKU-10023"]},"certificate_id":{"type":["string","null"],"examples":[null]},"is_image":{"type":"integer","examples":[0]},"icon":{"type":"string","examples":["fab fa-accusoft"]},"variation_config":{"type":["string","null"],"examples":[null]},"has_quantity":{"type":"integer","examples":[1]},"quantity":{"type":"integer","examples":[54]},"max_per_user":{"type":"integer","examples":[0]},"has_serial":{"type":"integer","examples":[0]},"category_id":{"type":["string","null"],"examples":[null]},"serial_assignment_mode":{"type":["string","null"],"examples":[null]},"is_distributable":{"type":"integer","examples":[0]},"is_redeemable":{"type":"integer","examples":[0]},"ttl":{"type":["string","null"],"examples":[null]},"reward_point_cost":{"type":"integer","examples":[0]},"budget_cost":{"type":"string","examples":["0.00"]},"publish":{"type":"integer","examples":[1]},"sort_order":{"type":"integer","examples":[0]},"has_variants":{"type":"integer","examples":[0]},"varied_by_attribute_id":{"type":["string","null"],"examples":[null]},"variant_source_id":{"type":["string","null"],"examples":[null]},"is_archived":{"type":"integer","examples":[0]},"is_distributable_at_checkin_checkout":{"type":["string","null"],"examples":[null]},"deleted_at":{"type":["string","null"],"examples":[null]},"is_erased":{"type":"integer","examples":[0]},"created_at":{"type":"string","examples":["2026-06-09T05:36:26.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:26.000000Z"]},"deleted_by":{"type":["string","null"],"examples":[null]},"is_inheritable":{"type":"integer","examples":[0]},"name":{"type":"string","examples":["Volunteer T-Shirt"]}}},"nice":{"type":"object","properties":{"created_at":{"type":"string","examples":["Jun 9, 2026, 5:36 AM"]},"created_at__date":{"type":"string","examples":["Jun 9, 2026"]},"created_at__time":{"type":"string","examples":["5:36 AM"]},"created_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"created_at__offset_minutes":{"type":"integer","examples":[0]},"created_at__dayofweek":{"type":"string","examples":["Tuesday"]},"external_id":{"type":"string","examples":["SKU-10023"]},"has_quantity":{"type":"string","examples":["Yes"]},"has_variants":{"type":"string","examples":["No"]},"is_distributable_at_checkin_checkout":{"type":"string","examples":["No"]},"name":{"type":"string","examples":["Volunteer T-Shirt"]},"publish":{"type":"string","examples":["Yes"]},"type":{"type":"string","examples":["Distributable"]},"type:value":{"type":"string","examples":["distributable"]},"type:array":{"type":"string","examples":["Distributable"]},"updated_at":{"type":"string","examples":["Jun 9, 2026, 5:36 AM"]},"updated_at__date":{"type":"string","examples":["Jun 9, 2026"]},"updated_at__time":{"type":"string","examples":["5:36 AM"]},"updated_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"updated_at__offset_minutes":{"type":"integer","examples":[0]},"updated_at__dayofweek":{"type":"string","examples":["Tuesday"]},"distributed":{"type":"integer","examples":[1]},"allocated":{"type":"integer","examples":[0]},"available":{"type":"integer","examples":[53]},"stock_level":{"type":"string","examples":["98%"]},"manual_serial_required":{"type":"boolean","examples":[false]},"account_name_path":{"type":"string","examples":["Rosterfy Subaccount"]},"is_foreign_account":{"type":"boolean","examples":[false]}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}}},"serial_obj":{"type":["string","null"],"examples":[null]}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]},"user_update":{"type":"boolean","examples":[true]}}}},"examples":[{"object":{"id":11,"inventory_allocation_id":null,"inventory_item_id":1,"user_id":1234,"entity":null,"entity_id":null,"inventory_allocation_type":"rewards","serial":null,"inventory_item_serial_id":null,"expires_at":"2026-06-10T05:36:49.000000Z","collected_at":"2026-06-02T05:29:35.000000Z","collected_entity":null,"collected_by":null,"data":null,"sort_order":0,"deleted_at":null,"created_at":"2026-06-09T05:36:49.000000Z","updated_at":"2026-06-09T05:36:49.000000Z"},"nice":{"inventory_allocation_type":"Rewards","user_name":"Alex Example"},"relations":{"user":{"object":{"id":1234,"first_name":"Alex","last_name":"Example","email":"alex.example@example.com"},"nice":{"first_name":"Alex","last_name":"Example"},"permissions":{"read":true,"update":true,"delete":true},"id":1234,"name":"Alex Example"},"inventory_allocation":null,"inventory_item":{"object":{"id":1,"parent_id":null,"type":"distributable","external_id":"SKU-10023","certificate_id":null,"is_image":0,"icon":"fab fa-accusoft","variation_config":null,"has_quantity":1,"quantity":54,"max_per_user":0,"has_serial":0,"category_id":null,"serial_assignment_mode":null,"is_distributable":0,"is_redeemable":0,"ttl":null,"reward_point_cost":0,"budget_cost":"0.00","publish":1,"sort_order":0,"has_variants":0,"varied_by_attribute_id":null,"variant_source_id":null,"is_archived":0,"is_distributable_at_checkin_checkout":null,"deleted_at":null,"is_erased":0,"created_at":"2026-06-09T05:36:26.000000Z","updated_at":"2026-06-09T05:36:26.000000Z","deleted_by":null,"is_inheritable":0,"name":"Volunteer T-Shirt"},"nice":{"created_at":"Jun 9, 2026, 5:36 AM","created_at__date":"Jun 9, 2026","created_at__time":"5:36 AM","created_at__offset":" (+00:00 UTC)","created_at__offset_minutes":0,"created_at__dayofweek":"Tuesday","external_id":"SKU-10023","has_quantity":"Yes","has_variants":"No","is_distributable_at_checkin_checkout":"No","name":"Volunteer T-Shirt","publish":"Yes","type":"Distributable","type:value":"distributable","type:array":"Distributable","updated_at":"Jun 9, 2026, 5:36 AM","updated_at__date":"Jun 9, 2026","updated_at__time":"5:36 AM","updated_at__offset":" (+00:00 UTC)","updated_at__offset_minutes":0,"updated_at__dayofweek":"Tuesday","distributed":1,"allocated":0,"available":53,"stock_level":"98%","manual_serial_required":false,"account_name_path":"Rosterfy Subaccount","is_foreign_account":false},"permissions":{"read":true,"update":true,"delete":true}},"serial_obj":null},"permissions":{"read":true,"update":true,"delete":true,"user_update":true}}]},"id":"schema_368"},"schema_369":{"kind":"json-schema","data":{"type":"integer","examples":[11]},"id":"schema_369"},"schema_370":{"kind":"json-schema","data":{"type":"object","properties":{"user_id":{"type":"integer","description":"The ID of the person the item is allocated to. Required on create.","examples":[1234]},"inventory_allocation_type":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How the person came by the item - for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rewards"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when they redeemed it with points. Recorded against the allocation and used in reporting; it does not change how the allocation behaves."},"children":[]}]}]}],"examples":["rewards"]},"expires_at":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the allocation stops being valid, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD HH:MM:SS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Left unset on create, it is worked out from the item's validity period if it has one."},"children":[]}]}]}],"examples":["2026-06-10T05:36:49.000000Z"]},"collected_at":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the person physically received the item, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD HH:MM:SS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Leave unset for an allocation that has not been handed over yet; an allocation with no collection time is what the collect endpoint acts on."},"children":[]}]}]}],"examples":["2026-06-02T05:29:35.000000Z"]},"quantity":{"type":"integer","description":"Not stored. The allocation record holds one unit, so this field is accepted and then discarded - allocate the item more than once to give someone several.","examples":[1]}}},"id":"schema_370"},"schema_371":{"kind":"json-schema","data":{"type":"object","properties":{"inventory_item_id":{"type":"integer","description":"The ID of the item to allocate. Required, and it must be an item the account can use.","examples":[1]},"inventory_allocation_type":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How the people being allocated the item came by it - for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rewards"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Recorded against each allocation and used in reporting."},"children":[]}]}]}],"examples":[null]},"quantity":{"type":"integer","description":"How many of the item each person gets. Required. Unlike the single-allocation endpoint, this figure is honoured: the item is allocated this many times to every person matched.","examples":[1]},"applyTo":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to allocate to the people named in selected. Any other value allocates to every person the caller can see, narrowed by filter if one is sent."},"children":[]}]}]}],"examples":[null]},"expires_at":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the allocations stop being valid, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD HH:MM:SS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Left unset, each allocation takes its expiry from the item's validity period if it has one. Applies to distributable items."},"children":[]}]}]}],"examples":[null]},"collected_at":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the item was handed over, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD HH:MM:SS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Set it to record allocations that have already been collected. Applies to distributable items."},"children":[]}]}]}],"examples":[null]},"selected":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The IDs of the people to allocate to. Required when applyTo is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and ignored otherwise."},"children":[]}]}]}],"items":{"type":"integer"},"examples":[[]]},"filter":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Narrows who the item is allocated to when applyTo is not "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", using the same filter syntax as the user listing."},"children":[]}]}]}],"items":{"type":"object"},"examples":[[]]}},"required":["inventory_item_id","inventory_allocation_type","quantity","applyTo"]},"id":"schema_371"},"schema_372":{"kind":"json-schema","data":{"type":"object","properties":{"user_ids":{"type":"array","description":"The IDs of the people whose allocations are being collected. An entry in items is only matched against allocations held by one of these people.","items":{"type":"integer"},"examples":[[]]},"items":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The allocations being collected. Each entry is an object with an "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"item_user_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", the ID of the allocation to mark as collected, and, for an item whose serials are assigned by hand, a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"serial"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" naming the unit handed over. Every entry is checked before anything is recorded, and one bad entry rejects the whole request."},"children":[]}]}]}],"items":{"type":"object"},"examples":[[]]}},"required":["user_ids","items"]},"id":"schema_372"},"schema_373":{"kind":"json-schema","data":{"type":"object","properties":{"name":{"type":"string","description":"A name for the allocation rule, used wherever it is listed.","examples":["Event Volunteer T-Shirt"]},"type":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"What the people who qualify are being given. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"entitlements"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for something they have earned, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rewards"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for something granted as a reward, and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"redemption"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for something exchanged for points. The value is recorded on every allocation the rule creates and is used in reporting. Send one of the three: other values are accepted here but stop the rule allocating anything when it next runs."},"children":[]}]}]}],"examples":["entitlements"]},"rules":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The qualifying condition, as a list holding exactly one entry of the form "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{\"type\": \"<measure>\", \"value\": <threshold>}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the measure to count and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"value"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the number the person has to reach. The measures are "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"total_number_of_shifts"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"total_number_of_events"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"total_shift_hours"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (counted from scheduled times), "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"total_shift_hours_attended"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (counted from check-in to check-out) and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"shift_hours_per_day"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Required - and note that anything else, including an empty list, more than one entry, an unrecognised measure or a missing threshold, is rejected with a message saying the field is required rather than one describing what was wrong."},"children":[]}]}]}],"items":{"type":"object"},"examples":[[{"type":"total_number_of_shifts","value":5}]]},"conditions":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An optional list of further conditions narrowing who the rule applies to, on top of the measure in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rules"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The structure is not currently validated and is not part of this contract - build it in the console rather than by hand, and send back what you were given if you are updating a rule that already has one."},"children":[]}]}]}],"items":{"type":"object"},"examples":[[]]}},"required":["name","type","rules"]},"id":"schema_373"},"schema_374":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"rules":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","examples":["total_number_of_shifts"]},"value":{"type":"integer","examples":[5]}}},"examples":[[{"type":"total_number_of_shifts","value":5}]]},"conditions":{"type":"array","examples":[[]]},"type":{"type":"string","examples":["entitlements"]},"name":{"type":"string","examples":["Event Volunteer T-Shirt"]},"updated_at":{"type":"string","examples":["2026-08-06T05:57:11.000000Z"]},"created_at":{"type":"string","examples":["2026-08-06T05:57:11.000000Z"]},"id":{"type":"integer","examples":[1]}}},"nice":{"type":"object","properties":{"rule_name":{"type":"string","examples":["Total Number Of Shifts"]},"rule_value":{"type":"integer","examples":[5]}}},"relations":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}},"examples":[{"object":{"rules":[{"type":"total_number_of_shifts","value":5}],"conditions":[],"type":"entitlements","name":"Event Volunteer T-Shirt","updated_at":"2026-08-06T05:57:11.000000Z","created_at":"2026-08-06T05:57:11.000000Z","id":1},"nice":{"rule_name":"Total Number Of Shifts","rule_value":5},"relations":[],"permissions":{"read":true,"update":true,"delete":true}}]},"id":"schema_374"},"schema_375":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"type":{"type":"string","examples":["entitlements"]},"name":{"type":"string","examples":["Event Volunteer T-Shirt"]},"rules":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","examples":["total_number_of_shifts"]},"value":{"type":"integer","examples":[5]}}},"examples":[[{"type":"total_number_of_shifts","value":5}]]},"conditions":{"type":"array","examples":[[]]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-08-06T05:57:11.000000Z"]},"updated_at":{"type":"string","examples":["2026-08-06T05:57:11.000000Z"]}}},"nice":{"type":"object","properties":{"rule_name":{"type":"string","examples":["Total Number Of Shifts"]},"rule_value":{"type":"integer","examples":[5]}}},"relations":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"inventory_item_id":{"type":"integer","examples":[1]},"quantity":{"type":"integer","examples":[1]},"valid_duration":{"type":"integer","examples":[31536000]},"created_at":{"type":"string","examples":["2026-08-06T05:57:11.000000Z"]},"updated_at":{"type":"string","examples":["2026-08-06T05:57:11.000000Z"]}}},"nice":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}}},"examples":[[{"object":{"id":1,"inventory_item_id":1,"quantity":1,"valid_duration":31536000,"created_at":"2026-08-06T05:57:11.000000Z","updated_at":"2026-08-06T05:57:11.000000Z"},"nice":[],"permissions":{"read":true,"update":true,"delete":true}}]]}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}},"examples":[{"object":{"id":1,"type":"entitlements","name":"Event Volunteer T-Shirt","rules":[{"type":"total_number_of_shifts","value":5}],"conditions":[],"deleted_at":null,"created_at":"2026-08-06T05:57:11.000000Z","updated_at":"2026-08-06T05:57:11.000000Z"},"nice":{"rule_name":"Total Number Of Shifts","rule_value":5},"relations":{"items":[{"object":{"id":1,"inventory_item_id":1,"quantity":1,"valid_duration":31536000,"created_at":"2026-08-06T05:57:11.000000Z","updated_at":"2026-08-06T05:57:11.000000Z"},"nice":[],"permissions":{"read":true,"update":true,"delete":true}}]},"permissions":{"read":true,"update":true,"delete":true}}]},"id":"schema_375"},"schema_376":{"kind":"json-schema","data":{"type":"object","properties":{"name":{"type":"string","description":"A name for the allocation rule, used wherever it is listed.","examples":["Event Volunteer T-Shirt"]},"type":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"What the people who qualify are being given. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"entitlements"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for something they have earned, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rewards"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for something granted as a reward, and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"redemption"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for something exchanged for points. The value is recorded on every allocation the rule creates and is used in reporting. Send one of the three: other values are accepted here but stop the rule allocating anything when it next runs."},"children":[]}]}]}],"examples":["entitlements"]},"rules":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The qualifying condition, as a list holding exactly one entry of the form "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{\"type\": \"<measure>\", \"value\": <threshold>}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the measure to count and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"value"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the number the person has to reach. The measures are "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"total_number_of_shifts"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"total_number_of_events"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"total_shift_hours"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (counted from scheduled times), "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"total_shift_hours_attended"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (counted from check-in to check-out) and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"shift_hours_per_day"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Required - and note that anything else, including an empty list, more than one entry, an unrecognised measure or a missing threshold, is rejected with a message saying the field is required rather than one describing what was wrong."},"children":[]}]}]}],"items":{"type":"object"},"examples":[[{"type":"total_number_of_shifts","value":5}]]},"conditions":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An optional list of further conditions narrowing who the rule applies to, on top of the measure in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rules"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The structure is not currently validated and is not part of this contract - build it in the console rather than by hand, and send back what you were given if you are updating a rule that already has one."},"children":[]}]}]}],"items":{"type":"object"},"examples":[[]]}}},"id":"schema_376"},"schema_377":{"kind":"json-schema","data":{"type":"object","properties":{"inventory_item_id":{"type":"integer","description":"The ID of the catalogue item to give out.","examples":[1]},"quantity":{"type":"integer","description":"How many of the item each qualifying person receives, as a whole number of 1 or more. Each one is allocated separately, so a quantity of 3 produces three allocations.","examples":[1]},"valid_duration":{"type":"integer","description":"How long the allocation stays valid, in seconds, counted from the moment it is granted. Leave it unset for an allocation that does not expire.","examples":[31536000]}},"required":["inventory_item_id","quantity"]},"id":"schema_377"},"schema_378":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"inventory_item_id":{"type":"integer","examples":[1]},"quantity":{"type":"integer","examples":[1]},"valid_duration":{"type":"integer","examples":[31536000]},"created_at":{"type":"string","examples":["2026-08-06T05:57:11.000000Z"]},"updated_at":{"type":"string","examples":["2026-08-06T05:57:11.000000Z"]}}},"nice":{"type":"array","examples":[[]]},"relations":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}},"examples":[{"object":{"id":1,"inventory_item_id":1,"quantity":1,"valid_duration":31536000,"created_at":"2026-08-06T05:57:11.000000Z","updated_at":"2026-08-06T05:57:11.000000Z"},"nice":[],"relations":[],"permissions":{"read":true,"update":true,"delete":true}}]},"id":"schema_378"},"schema_379":{"kind":"json-schema","data":{"type":"object","properties":{"inventory_item_id":{"type":"integer","description":"The ID of the catalogue item to give out.","examples":[1]},"quantity":{"type":"integer","description":"How many of the item each qualifying person receives, as a whole number of 1 or more. Each one is allocated separately, so a quantity of 3 produces three allocations.","examples":[1]},"valid_duration":{"type":"integer","description":"How long the allocation stays valid, in seconds, counted from the moment it is granted. Leave it unset for an allocation that does not expire.","examples":[31536000]}}},"id":"schema_379"},"schema_380":{"kind":"json-schema","data":{"type":"array","items":{"type":"object","properties":{"current_page":{"type":"integer","examples":[1]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[21]},"report_type_id":{"type":"integer","examples":[36]},"report_category_id":{"type":["string","null"],"examples":[null]},"user_id":{"type":"integer","examples":[23453473]},"name":{"type":"string","examples":["Payment Report"]},"filters":{"type":"array","examples":[[]]},"columns":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","examples":["user ID"]},"label":{"type":"string","examples":["user ID"]},"value":{"type":"string","examples":["[user.id]"]}}},"examples":[[{"name":"user ID","label":"user ID","value":"[user.id]"},{"name":"role_offer ID","label":"role_offer ID","value":"[role_offer.id]"},{"name":"role_offer_user ID","label":"role_offer_user ID","value":"[role_offer_user.id]"},{"name":"payment_user ID","label":"payment_user ID","value":"[payment_user.id]"}]]},"sorting":{"type":"array","examples":[[]]},"grouping":{"type":"array","examples":[[]]},"with_media":{"type":"integer","examples":[0]},"with_subaccounts":{"type":"integer","examples":[0]},"file_path":{"type":["string","null"],"examples":[null]},"file_type":{"type":"string","examples":["xlsx"]},"status":{"type":"string","examples":["queued"]},"error_message":{"type":["string","null"],"examples":[null]},"is_scheduled":{"type":"integer","examples":[0]},"start_date":{"type":["string","null"],"examples":[null]},"start_time":{"type":["string","null"],"examples":[null]},"end_date":{"type":["string","null"],"examples":[null]},"timezone":{"type":["string","null"],"examples":[null]},"repeat":{"type":["string","null"],"examples":[null]},"meta":{"type":"array","examples":[[]]},"last_generated_at":{"type":["string","null"],"examples":[null]},"destination_meta":{"type":["string","null"],"examples":[null]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-06-09T05:36:34.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:34.000000Z"]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:report:21"]},"status":{"type":"string","examples":["Queued"]},"columns_preview":{"type":"string","examples":["user ID, role_offer ID, role_offer_user ID, payment_user ID"]}}},"relations":{"type":"object","properties":{"report_type":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[36]},"type":{"type":"string","examples":["payment_user"]},"name":{"type":"string","examples":["Payment Report"]},"entities":{"type":"array","items":{"type":"string"},"examples":[["user","role_offer","role_offer_user","payment_user"]]},"only_trashed":{"type":"integer","examples":[0]},"filters":{"type":["string","null"],"examples":[null]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2024-08-08T10:32:42.000000Z"]},"updated_at":{"type":"string","examples":["2024-08-08T10:32:42.000000Z"]}}},"nice":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[false]},"delete":{"type":"boolean","examples":[false]}}}}}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]},"share":{"type":"boolean","examples":[true]}}}}},"examples":[[{"object":{"id":21,"report_type_id":36,"report_category_id":null,"user_id":23453473,"name":"Payment Report","filters":[],"columns":[{"name":"user ID","label":"user ID","value":"[user.id]"},{"name":"role_offer ID","label":"role_offer ID","value":"[role_offer.id]"},{"name":"role_offer_user ID","label":"role_offer_user ID","value":"[role_offer_user.id]"},{"name":"payment_user ID","label":"payment_user ID","value":"[payment_user.id]"}],"sorting":[],"grouping":[],"with_media":0,"with_subaccounts":0,"file_path":null,"file_type":"xlsx","status":"queued","error_message":null,"is_scheduled":0,"start_date":null,"start_time":null,"end_date":null,"timezone":null,"repeat":null,"meta":[],"last_generated_at":null,"destination_meta":null,"deleted_at":null,"created_at":"2026-06-09T05:36:34.000000Z","updated_at":"2026-06-09T05:36:34.000000Z"},"nice":{"rrn":"rrn:local:20101:report:21","status":"Queued","columns_preview":"user ID, role_offer ID, role_offer_user ID, payment_user ID"},"relations":{"report_type":{"object":{"id":36,"type":"payment_user","name":"Payment Report","entities":["user","role_offer","role_offer_user","payment_user"],"only_trashed":0,"filters":null,"deleted_at":null,"created_at":"2024-08-08T10:32:42.000000Z","updated_at":"2024-08-08T10:32:42.000000Z"},"nice":[],"permissions":{"read":true,"update":false,"delete":false}}},"permissions":{"read":true,"update":true,"delete":true,"share":true}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}]]},"first_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/report?per_page=5&_locale=en-US&page=1"]},"from":{"type":"integer","examples":[1]},"next_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/report?per_page=5&_locale=en-US&page=2"]},"path":{"type":"string","examples":["https://example.rosterfy.com/api/v2/report"]},"per_page":{"type":"integer","examples":[5]},"prev_page_url":{"type":["string","null"],"examples":[null]},"to":{"type":"integer","examples":[5]}}},"examples":[[{"current_page":1,"data":[{"object":{"id":21,"report_type_id":36,"report_category_id":null,"user_id":23453473,"name":"Payment Report","filters":[],"columns":[{"name":"user ID","label":"user ID","value":"[user.id]"},{"name":"role_offer ID","label":"role_offer ID","value":"[role_offer.id]"},{"name":"role_offer_user ID","label":"role_offer_user ID","value":"[role_offer_user.id]"},{"name":"payment_user ID","label":"payment_user ID","value":"[payment_user.id]"}],"sorting":[],"grouping":[],"with_media":0,"with_subaccounts":0,"file_path":null,"file_type":"xlsx","status":"queued","error_message":null,"is_scheduled":0,"start_date":null,"start_time":null,"end_date":null,"timezone":null,"repeat":null,"meta":[],"last_generated_at":null,"destination_meta":null,"deleted_at":null,"created_at":"2026-06-09T05:36:34.000000Z","updated_at":"2026-06-09T05:36:34.000000Z"},"nice":{"rrn":"rrn:local:20101:report:21","status":"Queued","columns_preview":"user ID, role_offer ID, role_offer_user ID, payment_user ID"},"relations":{"report_type":{"object":{"id":36,"type":"payment_user","name":"Payment Report","entities":["user","role_offer","role_offer_user","payment_user"],"only_trashed":0,"filters":null,"deleted_at":null,"created_at":"2024-08-08T10:32:42.000000Z","updated_at":"2024-08-08T10:32:42.000000Z"},"nice":[],"permissions":{"read":true,"update":false,"delete":false}}},"permissions":{"read":true,"update":true,"delete":true,"share":true}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}],"first_page_url":"https://example.rosterfy.com/api/v2/report?per_page=5&_locale=en-US&page=1","from":1,"next_page_url":"https://example.rosterfy.com/api/v2/report?per_page=5&_locale=en-US&page=2","path":"https://example.rosterfy.com/api/v2/report","per_page":5,"prev_page_url":null,"to":5}]]},"id":"schema_380"},"schema_381":{"kind":"json-schema","data":{"type":"object","properties":{"report_type_id":{"type":"integer","description":"The kind of data the report extracts, from the report type list. Determines which columns and filters are available. Treat it as fixed once the report exists: the update endpoint accepts the field, but changing the type of an existing report is not supported.","examples":[36]},"name":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Display name for the report, up to 255 characters. Also used as the report template name when _options.save_as_template is set on create."},"children":[]}]}]}],"examples":["Payment Report"]},"file_type":{"type":"string","description":"Output format of the generated file: xlsx or csv.","examples":["xlsx"]},"filters":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Conditions restricting which records the report includes, as groups of {attribute, operator, value} objects. Rows missing an attribute or operator are dropped on save rather than rejected, so a report can come back with fewer filters than were sent."},"children":[]}]}]}],"items":{"type":"object"},"examples":[[]]},"sorting":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Order to output rows in, as a list of {field, direction} objects where direction is asc or desc. Only sortable columns of the report's primary entity are applied; anything else is ignored."},"children":[]}]}]}],"items":{"type":"object"},"examples":[[]]},"columns":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The columns to output, in order, as objects carrying at least a value such as \"[user.email]\" plus its name and label. Required, and limited to 60 columns of which at most 55 may be custom fields."},"children":[]}]}]}],"items":{"type":"object"},"examples":[[{"name":"user ID","label":"user ID","value":"[user.id]"},{"name":"role_offer ID","label":"role_offer ID","value":"[role_offer.id]"},{"name":"role_offer_user ID","label":"role_offer_user ID","value":"[role_offer_user.id]"},{"name":"payment_user ID","label":"payment_user ID","value":"[payment_user.id]"}]]},"with_media":{"type":"boolean","description":"Whether to deliver the report as a zip containing the uploaded files its rows reference, rather than the spreadsheet on its own.","examples":[0]},"with_subaccounts":{"type":"boolean","description":"Whether to include records belonging to accounts below this one in the hierarchy.","examples":[0]},"is_scheduled":{"type":"boolean","description":"Whether the report runs on a schedule instead of immediately. Setting it makes the schedule fields required, and is capped by the account's max scheduled report limit. Leaving it false queues the report for generation as soon as the request returns, and clears any schedule already stored.","examples":[0]},"start_date":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"First date the schedule runs, as YYYY-MM-DD. Required when is_scheduled is true."},"children":[]}]}]}],"examples":[null]},"start_time":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Time of day the schedule runs, as HH:MM in the report's timezone. Required when is_scheduled is true."},"children":[]}]}]}],"examples":[null]},"end_date":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Date the schedule stops running, as YYYY-MM-DD. Required when is_scheduled is true."},"children":[]}]}]}],"examples":[null]},"timezone":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Timezone the schedule's dates and times are interpreted in, as a tz database name such as Australia/Melbourne. Required when is_scheduled is true; defaults to the account's timezone."},"children":[]}]}]}],"examples":[null]},"repeat":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How often the schedule repeats, as an interval and unit joined by a pipe - \"1|day\", \"2|week\" or \"1|month\". Required when is_scheduled is true."},"children":[]}]}]}],"examples":[null]},"destination_meta":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Where a scheduled report delivers its file. source selects the transport, sftp or ftp, and the remaining keys configure it: sftp takes sftp_host, sftp_port, sftp_username, sftp_authentication (password or key), then sftp_password or sftp_privateKey, and an optional sftp_directory; ftp takes ftp_host, ftp_port, ftp_username, ftp_password, ftp_passive and ftp_ssl. Keys that do not belong to the chosen source are stripped on save, the whole object is discarded if is_scheduled is false, and credentials are stored encrypted."},"children":[]}]}]}],"properties":{},"examples":["{}"]},"meta":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Additional per-report-type options. use_field_value outputs the stored value of a custom field rather than its label. Some report types require their own subkeys - the inventory bundle type requires meta.bundle_template_id."},"children":[]}]}]}],"properties":{},"examples":[[]]},"report_category_id":{"type":"integer","description":"Optional category to file the report under. Reports left uncategorised return null.","examples":[1]}},"required":["report_type_id","name","file_type","columns"]},"id":"schema_381"},"schema_382":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[21]},"report_type_id":{"type":"integer","examples":[36]},"report_category_id":{"type":["string","null"],"examples":[null]},"user_id":{"type":"integer","examples":[23453473]},"name":{"type":"string","examples":["Payment Report"]},"filters":{"type":"array","examples":[[]]},"columns":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","examples":["user ID"]},"label":{"type":"string","examples":["user ID"]},"value":{"type":"string","examples":["[user.id]"]}}},"examples":[[{"name":"user ID","label":"user ID","value":"[user.id]"},{"name":"role_offer ID","label":"role_offer ID","value":"[role_offer.id]"},{"name":"role_offer_user ID","label":"role_offer_user ID","value":"[role_offer_user.id]"},{"name":"payment_user ID","label":"payment_user ID","value":"[payment_user.id]"}]]},"sorting":{"type":"array","examples":[[]]},"grouping":{"type":"array","examples":[[]]},"with_media":{"type":"integer","examples":[0]},"with_subaccounts":{"type":"integer","examples":[0]},"file_path":{"type":["string","null"],"examples":[null]},"file_type":{"type":"string","examples":["xlsx"]},"status":{"type":"string","examples":["queued"]},"error_message":{"type":["string","null"],"examples":[null]},"is_scheduled":{"type":"integer","examples":[0]},"start_date":{"type":["string","null"],"examples":[null]},"start_time":{"type":["string","null"],"examples":[null]},"end_date":{"type":["string","null"],"examples":[null]},"timezone":{"type":["string","null"],"examples":[null]},"repeat":{"type":["string","null"],"examples":[null]},"meta":{"type":"array","examples":[[]]},"last_generated_at":{"type":["string","null"],"examples":[null]},"destination_meta":{"type":["string","null"],"examples":[null]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-06-09T05:36:34.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:34.000000Z"]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:report:21"]},"status":{"type":"string","examples":["Queued"]},"columns_preview":{"type":"string","examples":["user ID, role_offer ID, role_offer_user ID, payment_user ID"]}}},"relations":{"type":"object","properties":{"report_type":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[36]},"type":{"type":"string","examples":["payment_user"]},"name":{"type":"string","examples":["Payment Report"]},"entities":{"type":"array","items":{"type":"string"},"examples":[["user","role_offer","role_offer_user","payment_user"]]},"only_trashed":{"type":"integer","examples":[0]},"filters":{"type":["string","null"],"examples":[null]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2024-08-08T10:32:42.000000Z"]},"updated_at":{"type":"string","examples":["2024-08-08T10:32:42.000000Z"]}}},"nice":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[false]},"delete":{"type":"boolean","examples":[false]}}}}}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]},"share":{"type":"boolean","examples":[true]}}}},"examples":[{"object":{"id":21,"report_type_id":36,"report_category_id":null,"user_id":23453473,"name":"Payment Report","filters":[],"columns":[{"name":"user ID","label":"user ID","value":"[user.id]"},{"name":"role_offer ID","label":"role_offer ID","value":"[role_offer.id]"},{"name":"role_offer_user ID","label":"role_offer_user ID","value":"[role_offer_user.id]"},{"name":"payment_user ID","label":"payment_user ID","value":"[payment_user.id]"}],"sorting":[],"grouping":[],"with_media":0,"with_subaccounts":0,"file_path":null,"file_type":"xlsx","status":"queued","error_message":null,"is_scheduled":0,"start_date":null,"start_time":null,"end_date":null,"timezone":null,"repeat":null,"meta":[],"last_generated_at":null,"destination_meta":null,"deleted_at":null,"created_at":"2026-06-09T05:36:34.000000Z","updated_at":"2026-06-09T05:36:34.000000Z"},"nice":{"rrn":"rrn:local:20101:report:21","status":"Queued","columns_preview":"user ID, role_offer ID, role_offer_user ID, payment_user ID"},"relations":{"report_type":{"object":{"id":36,"type":"payment_user","name":"Payment Report","entities":["user","role_offer","role_offer_user","payment_user"],"only_trashed":0,"filters":null,"deleted_at":null,"created_at":"2024-08-08T10:32:42.000000Z","updated_at":"2024-08-08T10:32:42.000000Z"},"nice":[],"permissions":{"read":true,"update":false,"delete":false}}},"permissions":{"read":true,"update":true,"delete":true,"share":true}}]},"id":"schema_382"},"schema_383":{"kind":"json-schema","data":{"type":"integer","examples":[21]},"id":"schema_383"},"schema_384":{"kind":"json-schema","data":{"type":"object","properties":{"report_type_id":{"type":"integer","description":"The kind of data the report extracts, from the report type list. Determines which columns and filters are available. Treat it as fixed once the report exists: the update endpoint accepts the field, but changing the type of an existing report is not supported.","examples":[36]},"user_id":{"type":"integer","description":"The report owner, who receives the completion notification. Set from the caller on create and ignored if sent; supplying it on update reassigns the report to another user.","examples":[23453473]},"name":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Display name for the report, up to 255 characters. Also used as the report template name when _options.save_as_template is set on create."},"children":[]}]}]}],"examples":["Payment Report"]},"file_type":{"type":"string","description":"Output format of the generated file: xlsx or csv.","examples":["xlsx"]},"filters":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Conditions restricting which records the report includes, as groups of {attribute, operator, value} objects. Rows missing an attribute or operator are dropped on save rather than rejected, so a report can come back with fewer filters than were sent."},"children":[]}]}]}],"items":{"type":"object"},"examples":[[]]},"sorting":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Order to output rows in, as a list of {field, direction} objects where direction is asc or desc. Only sortable columns of the report's primary entity are applied; anything else is ignored."},"children":[]}]}]}],"items":{"type":"object"},"examples":[[]]},"columns":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The columns to output, in order, as objects carrying at least a value such as \"[user.email]\" plus its name and label. Required, and limited to 60 columns of which at most 55 may be custom fields."},"children":[]}]}]}],"items":{"type":"object"},"examples":[[{"name":"user ID","label":"user ID","value":"[user.id]"},{"name":"role_offer ID","label":"role_offer ID","value":"[role_offer.id]"},{"name":"role_offer_user ID","label":"role_offer_user ID","value":"[role_offer_user.id]"},{"name":"payment_user ID","label":"payment_user ID","value":"[payment_user.id]"}]]},"with_media":{"type":"boolean","description":"Whether to deliver the report as a zip containing the uploaded files its rows reference, rather than the spreadsheet on its own.","examples":[0]},"with_subaccounts":{"type":"boolean","description":"Whether to include records belonging to accounts below this one in the hierarchy.","examples":[0]},"is_scheduled":{"type":"boolean","description":"Whether the report runs on a schedule instead of immediately. Setting it makes the schedule fields required, and is capped by the account's max scheduled report limit. Leaving it false queues the report for generation as soon as the request returns, and clears any schedule already stored.","examples":[0]},"start_date":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"First date the schedule runs, as YYYY-MM-DD. Required when is_scheduled is true."},"children":[]}]}]}],"examples":[null]},"start_time":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Time of day the schedule runs, as HH:MM in the report's timezone. Required when is_scheduled is true."},"children":[]}]}]}],"examples":[null]},"end_date":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Date the schedule stops running, as YYYY-MM-DD. Required when is_scheduled is true."},"children":[]}]}]}],"examples":[null]},"timezone":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Timezone the schedule's dates and times are interpreted in, as a tz database name such as Australia/Melbourne. Required when is_scheduled is true; defaults to the account's timezone."},"children":[]}]}]}],"examples":[null]},"repeat":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How often the schedule repeats, as an interval and unit joined by a pipe - \"1|day\", \"2|week\" or \"1|month\". Required when is_scheduled is true."},"children":[]}]}]}],"examples":[null]},"destination_meta":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Where a scheduled report delivers its file. source selects the transport, sftp or ftp, and the remaining keys configure it: sftp takes sftp_host, sftp_port, sftp_username, sftp_authentication (password or key), then sftp_password or sftp_privateKey, and an optional sftp_directory; ftp takes ftp_host, ftp_port, ftp_username, ftp_password, ftp_passive and ftp_ssl. Keys that do not belong to the chosen source are stripped on save, the whole object is discarded if is_scheduled is false, and credentials are stored encrypted."},"children":[]}]}]}],"properties":{},"examples":["{}"]},"meta":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Additional per-report-type options. use_field_value outputs the stored value of a custom field rather than its label. Some report types require their own subkeys - the inventory bundle type requires meta.bundle_template_id."},"children":[]}]}]}],"properties":{},"examples":[[]]},"report_category_id":{"type":"integer","description":"Optional category to file the report under. Reports left uncategorised return null.","examples":[1]}}},"id":"schema_384"},"schema_385":{"kind":"json-schema","data":{"type":"boolean","description":"Return only role offers with unfilled demand.","examples":[true]},"id":"schema_385"},"schema_386":{"kind":"json-schema","data":{"type":"array","description":"A list of extras to include in the response. These are objects or arrays that are not part of\nthe model's primary attributes, such as stats and counts.\nFor fast responses, avoid requesting them if you don't need them. ","items":{"type":"string","enum":["demand","status","rules","shift_count"]},"examples":[["demand"]]},"id":"schema_386"},"schema_387":{"kind":"json-schema","data":{"type":"array","description":"A list of relations to include in the response. May be single records or collections.\nIt is often more efficient to retrieve this way, to avoid follow-up API calls.","items":{"type":"string","enum":["functional_area_type","location_type","hasManyDeepFromRelationsWithConstraints","hasOneDeepFromRelationsWithConstraints","hasManyDeepFromReverse","hasOneDeepFromReverse"]},"examples":[["functional_area_type"]]},"id":"schema_387"},"schema_388":{"kind":"json-schema","data":{"type":"array","items":{"type":"object","properties":{"current_page":{"type":"integer","examples":[1]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"headcount_functional_area_job_title_id":{"type":"integer","examples":[1]},"headcount_location_venue_id":{"type":"integer","examples":[10]},"journey_id":{"type":["string","null"],"examples":[null]},"role_offer_template_id":{"type":["string","null"],"examples":[null]},"user_type_id":{"type":"integer","examples":[2]},"certificate_id":{"type":["string","null"],"examples":[null]},"static_demand":{"type":"integer","examples":[12]},"reserve_demand":{"type":"integer","examples":[0]},"waitlist_demand":{"type":"integer","examples":[0]},"confidence_level":{"type":"integer","examples":[0]},"calculate_demand":{"type":"integer","examples":[0]},"refund_on_application_withdraw":{"type":"integer","examples":[0]},"refund_on_role_offer_complete":{"type":"integer","examples":[0]},"user_per_shift":{"type":"integer","examples":[0]},"peak_shift":{"type":"integer","examples":[0]},"min_demand":{"type":"integer","examples":[0]},"number_of_shifts_per_day":{"type":"integer","examples":[0]},"min_number_shift_users":{"type":"integer","examples":[0]},"max_number_shift_users":{"type":"integer","examples":[0]},"start_date":{"type":["string","null"],"examples":[null]},"end_date":{"type":["string","null"],"examples":[null]},"role_feedback_form_id":{"type":["string","null"],"examples":[null]},"secondary_assignment_demand":{"type":"integer","examples":[0]},"rules":{"type":"array","examples":[[]]},"ranking":{"type":["string","null"],"examples":[null]},"expires_in":{"type":"integer","examples":[0]},"preassign_enabled":{"type":"integer","examples":[1]},"sort_order":{"type":"integer","examples":[0]},"accept_form_id":{"type":["string","null"],"examples":[null]},"reject_form_id":{"type":["string","null"],"examples":[null]},"training_ids":{"type":"array","items":{"type":"integer"},"examples":[[1]]},"payment":{"type":["string","null"],"examples":[null]},"publish":{"type":"integer","examples":[1]},"promoted":{"type":"integer","examples":[0]},"is_archived":{"type":"integer","examples":[0]},"is_refund_allowed":{"type":"integer","examples":[0]},"created_by":{"type":["string","null"],"examples":[null]},"grid_image":{"type":["string","null"],"examples":[null]},"banner_image":{"type":["string","null"],"examples":[null]},"public":{"type":"integer","examples":[0]},"approval_status":{"type":"string","examples":["approved"]},"approval_reason":{"type":["string","null"],"examples":[null]},"visibility_show_groups":{"type":"array","examples":[[]]},"visibility_hide_groups":{"type":"array","examples":[[]]},"can_self_apply":{"type":"integer","examples":[0]},"application_form_id":{"type":["string","null"],"examples":[null]},"withdraw_form_id":{"type":["string","null"],"examples":[null]},"allows_application_withdrawals":{"type":"integer","examples":[0]},"timezone":{"type":["string","null"],"examples":[null]},"apps_open_timestamp":{"type":["string","null"],"examples":[null]},"apps_close_timestamp":{"type":["string","null"],"examples":[null]},"withdraw_close_timestamp":{"type":["string","null"],"examples":[null]},"minimum_dob":{"type":["string","null"],"examples":[null]},"minimum_age":{"type":["string","null"],"examples":[null]},"maximum_dob":{"type":["string","null"],"examples":[null]},"maximum_age":{"type":["string","null"],"examples":[null]},"applied_status_default":{"type":["string","null"],"examples":[null]},"withdrawn_status_default":{"type":["string","null"],"examples":[null]},"journey_complete_status_default":{"type":["string","null"],"examples":[null]},"deleted_at":{"type":["string","null"],"examples":[null]},"is_erased":{"type":"integer","examples":[0]},"strict_applications_enabled":{"type":"integer","examples":[0]},"waitlist_auto_invitation_enabled":{"type":"integer","examples":[0]},"created_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:31.000000Z"]},"deleted_by":{"type":["string","null"],"examples":[null]},"description":{"type":"string","examples":[""]},"tags":{"type":["string","null"],"examples":[null]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:role_offer:1"]},"accept_form_id":{"type":["string","null"],"examples":[null]},"accept_form_id:value":{"type":["string","null"],"examples":[null]},"accept_form_id:array":{"type":["string","null"],"examples":[null]},"allows_application_withdrawals":{"type":"string","examples":["No"]},"application_form_id":{"type":["string","null"],"examples":[null]},"application_form_id:value":{"type":["string","null"],"examples":[null]},"application_form_id:array":{"type":["string","null"],"examples":[null]},"applied_status_default":{"type":["string","null"],"examples":[null]},"applied_status_default:value":{"type":["string","null"],"examples":[null]},"applied_status_default:array":{"type":["string","null"],"examples":[null]},"approval_status":{"type":"string","examples":["Approved"]},"approval_status:value":{"type":"string","examples":["approved"]},"approval_status:array":{"type":"string","examples":["Approved"]},"banner_image":{"type":"string","examples":[""]},"calculate_demand":{"type":"string","examples":["No"]},"can_self_apply":{"type":"string","examples":["No"]},"created_at":{"type":"string","examples":["Jun 9, 2026, 5:36 AM"]},"created_at__date":{"type":"string","examples":["Jun 9, 2026"]},"created_at__time":{"type":"string","examples":["5:36 AM"]},"created_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"created_at__offset_minutes":{"type":"integer","examples":[0]},"created_at__dayofweek":{"type":"string","examples":["Tuesday"]},"feedback_form_id":{"type":["string","null"],"examples":[null]},"feedback_form_id:value":{"type":["string","null"],"examples":[null]},"feedback_form_id:array":{"type":["string","null"],"examples":[null]},"grid_image":{"type":"string","examples":[""]},"headcount_functional_area_job_title_id":{"type":"string","examples":["Accreditation > Veterinary Technician"]},"headcount_functional_area_job_title_id:value":{"type":"integer","examples":[1]},"headcount_functional_area_job_title_id:array":{"type":"string","examples":["Accreditation > Veterinary Technician"]},"headcount_location_venue_id":{"type":"string","examples":["Melbourne > Dot Etcher"]},"headcount_location_venue_id:value":{"type":"integer","examples":[10]},"headcount_location_venue_id:array":{"type":"string","examples":["Melbourne > Dot Etcher"]},"is_refund_allowed":{"type":"string","examples":["No"]},"journey_complete_status_default":{"type":["string","null"],"examples":[null]},"journey_complete_status_default:value":{"type":["string","null"],"examples":[null]},"journey_complete_status_default:array":{"type":["string","null"],"examples":[null]},"journey_id":{"type":["string","null"],"examples":[null]},"journey_id:value":{"type":["string","null"],"examples":[null]},"journey_id:array":{"type":["string","null"],"examples":[null]},"minimum_age":{"type":"string","examples":[""]},"preassign_enabled":{"type":"string","examples":["Yes"]},"promoted":{"type":"string","examples":["No"]},"public":{"type":"string","examples":["No"]},"publish":{"type":"string","examples":["Yes"]},"reject_form_id":{"type":["string","null"],"examples":[null]},"reject_form_id:value":{"type":["string","null"],"examples":[null]},"reject_form_id:array":{"type":["string","null"],"examples":[null]},"tags":{"type":["string","null"],"examples":[null]},"tags:value":{"type":["string","null"],"examples":[null]},"tags:array":{"type":["string","null"],"examples":[null]},"training_ids":{"type":"string","examples":["Paper Goods Machine Operator_EBMsffvoa9Ht"]},"training_ids:value":{"type":"string","examples":[""]},"training_ids:array":{"type":"array","items":{"type":"string"},"examples":[["Paper Goods Machine Operator_EBMsffvoa9Ht"]]},"updated_at":{"type":"string","examples":["Jun 9, 2026, 5:36 AM"]},"updated_at__date":{"type":"string","examples":["Jun 9, 2026"]},"updated_at__time":{"type":"string","examples":["5:36 AM"]},"updated_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"updated_at__offset_minutes":{"type":"integer","examples":[0]},"updated_at__dayofweek":{"type":"string","examples":["Tuesday"]},"user_type_id":{"type":"string","examples":["Default"]},"user_type_id:value":{"type":"integer","examples":[2]},"user_type_id:array":{"type":"string","examples":["Default"]},"visibility_hide_groups":{"type":"string","examples":[""]},"visibility_show_groups":{"type":"string","examples":[""]},"withdraw_form_id":{"type":["string","null"],"examples":[null]},"withdraw_form_id:value":{"type":["string","null"],"examples":[null]},"withdraw_form_id:array":{"type":["string","null"],"examples":[null]},"withdrawn_status_default":{"type":["string","null"],"examples":[null]},"withdrawn_status_default:value":{"type":["string","null"],"examples":[null]},"withdrawn_status_default:array":{"type":["string","null"],"examples":[null]},"account_id":{"type":"integer","examples":[20101]},"account_url":{"type":"string","examples":["https://sub.rosterfy2.localhost.com/"]},"confidence_level":{"type":"string","examples":["0%"]}}},"relations":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]},"accept":{"type":"boolean","examples":[false]},"reject":{"type":"boolean","examples":[false]},"withdraw":{"type":"boolean","examples":[false]},"apply":{"type":"boolean","examples":[false]},"apply_error":{"type":"string","examples":["Role offer not accepting applications at this time"]},"apply_error_code":{"type":"integer","examples":[1030]},"update_application_form":{"type":"boolean","examples":[false]}}}}},"examples":[[{"object":{"id":1,"headcount_functional_area_job_title_id":1,"headcount_location_venue_id":10,"journey_id":null,"role_offer_template_id":null,"user_type_id":2,"certificate_id":null,"static_demand":12,"reserve_demand":0,"waitlist_demand":0,"confidence_level":0,"calculate_demand":0,"refund_on_application_withdraw":0,"refund_on_role_offer_complete":0,"user_per_shift":0,"peak_shift":0,"min_demand":0,"number_of_shifts_per_day":0,"min_number_shift_users":0,"max_number_shift_users":0,"start_date":null,"end_date":null,"role_feedback_form_id":null,"secondary_assignment_demand":0,"rules":[],"ranking":null,"expires_in":0,"preassign_enabled":1,"sort_order":0,"accept_form_id":null,"reject_form_id":null,"training_ids":[1],"payment":null,"publish":1,"promoted":0,"is_archived":0,"is_refund_allowed":0,"created_by":null,"grid_image":null,"banner_image":null,"public":0,"approval_status":"approved","approval_reason":null,"visibility_show_groups":[],"visibility_hide_groups":[],"can_self_apply":0,"application_form_id":null,"withdraw_form_id":null,"allows_application_withdrawals":0,"timezone":null,"apps_open_timestamp":null,"apps_close_timestamp":null,"withdraw_close_timestamp":null,"minimum_dob":null,"minimum_age":null,"maximum_dob":null,"maximum_age":null,"applied_status_default":null,"withdrawn_status_default":null,"journey_complete_status_default":null,"deleted_at":null,"is_erased":0,"strict_applications_enabled":0,"waitlist_auto_invitation_enabled":0,"created_at":"2026-06-09T05:36:16.000000Z","updated_at":"2026-06-09T05:36:31.000000Z","deleted_by":null,"description":"","tags":null},"nice":{"rrn":"rrn:local:20101:role_offer:1","accept_form_id":null,"accept_form_id:value":null,"accept_form_id:array":null,"allows_application_withdrawals":"No","application_form_id":null,"application_form_id:value":null,"application_form_id:array":null,"applied_status_default":null,"applied_status_default:value":null,"applied_status_default:array":null,"approval_status":"Approved","approval_status:value":"approved","approval_status:array":"Approved","banner_image":"","calculate_demand":"No","can_self_apply":"No","created_at":"Jun 9, 2026, 5:36 AM","created_at__date":"Jun 9, 2026","created_at__time":"5:36 AM","created_at__offset":" (+00:00 UTC)","created_at__offset_minutes":0,"created_at__dayofweek":"Tuesday","feedback_form_id":null,"feedback_form_id:value":null,"feedback_form_id:array":null,"grid_image":"","headcount_functional_area_job_title_id":"Accreditation > Veterinary Technician","headcount_functional_area_job_title_id:value":1,"headcount_functional_area_job_title_id:array":"Accreditation > Veterinary Technician","headcount_location_venue_id":"Melbourne > Dot Etcher","headcount_location_venue_id:value":10,"headcount_location_venue_id:array":"Melbourne > Dot Etcher","is_refund_allowed":"No","journey_complete_status_default":null,"journey_complete_status_default:value":null,"journey_complete_status_default:array":null,"journey_id":null,"journey_id:value":null,"journey_id:array":null,"minimum_age":"","preassign_enabled":"Yes","promoted":"No","public":"No","publish":"Yes","reject_form_id":null,"reject_form_id:value":null,"reject_form_id:array":null,"tags":null,"tags:value":null,"tags:array":null,"training_ids":"Paper Goods Machine Operator_EBMsffvoa9Ht","training_ids:value":"","training_ids:array":["Paper Goods Machine Operator_EBMsffvoa9Ht"],"updated_at":"Jun 9, 2026, 5:36 AM","updated_at__date":"Jun 9, 2026","updated_at__time":"5:36 AM","updated_at__offset":" (+00:00 UTC)","updated_at__offset_minutes":0,"updated_at__dayofweek":"Tuesday","user_type_id":"Default","user_type_id:value":2,"user_type_id:array":"Default","visibility_hide_groups":"","visibility_show_groups":"","withdraw_form_id":null,"withdraw_form_id:value":null,"withdraw_form_id:array":null,"withdrawn_status_default":null,"withdrawn_status_default:value":null,"withdrawn_status_default:array":null,"account_id":20101,"account_url":"https://sub.rosterfy2.localhost.com/","confidence_level":"0%"},"relations":[],"permissions":{"read":true,"update":true,"delete":true,"accept":false,"reject":false,"withdraw":false,"apply":false,"apply_error":"Role offer not accepting applications at this time","apply_error_code":1030,"update_application_form":false}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}]]},"first_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/headcount/roleoffer?per_page=5&_locale=en-US&page=1"]},"from":{"type":"integer","examples":[1]},"next_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/headcount/roleoffer?per_page=5&_locale=en-US&page=2"]},"path":{"type":"string","examples":["https://example.rosterfy.com/api/v2/headcount/roleoffer"]},"per_page":{"type":"integer","examples":[5]},"prev_page_url":{"type":["string","null"],"examples":[null]},"to":{"type":"integer","examples":[5]}}},"examples":[[{"current_page":1,"data":[{"object":{"id":1,"headcount_functional_area_job_title_id":1,"headcount_location_venue_id":10,"journey_id":null,"role_offer_template_id":null,"user_type_id":2,"certificate_id":null,"static_demand":12,"reserve_demand":0,"waitlist_demand":0,"confidence_level":0,"calculate_demand":0,"refund_on_application_withdraw":0,"refund_on_role_offer_complete":0,"user_per_shift":0,"peak_shift":0,"min_demand":0,"number_of_shifts_per_day":0,"min_number_shift_users":0,"max_number_shift_users":0,"start_date":null,"end_date":null,"role_feedback_form_id":null,"secondary_assignment_demand":0,"rules":[],"ranking":null,"expires_in":0,"preassign_enabled":1,"sort_order":0,"accept_form_id":null,"reject_form_id":null,"training_ids":[1],"payment":null,"publish":1,"promoted":0,"is_archived":0,"is_refund_allowed":0,"created_by":null,"grid_image":null,"banner_image":null,"public":0,"approval_status":"approved","approval_reason":null,"visibility_show_groups":[],"visibility_hide_groups":[],"can_self_apply":0,"application_form_id":null,"withdraw_form_id":null,"allows_application_withdrawals":0,"timezone":null,"apps_open_timestamp":null,"apps_close_timestamp":null,"withdraw_close_timestamp":null,"minimum_dob":null,"minimum_age":null,"maximum_dob":null,"maximum_age":null,"applied_status_default":null,"withdrawn_status_default":null,"journey_complete_status_default":null,"deleted_at":null,"is_erased":0,"strict_applications_enabled":0,"waitlist_auto_invitation_enabled":0,"created_at":"2026-06-09T05:36:16.000000Z","updated_at":"2026-06-09T05:36:31.000000Z","deleted_by":null,"description":"","tags":null},"nice":{"rrn":"rrn:local:20101:role_offer:1","accept_form_id":null,"accept_form_id:value":null,"accept_form_id:array":null,"allows_application_withdrawals":"No","application_form_id":null,"application_form_id:value":null,"application_form_id:array":null,"applied_status_default":null,"applied_status_default:value":null,"applied_status_default:array":null,"approval_status":"Approved","approval_status:value":"approved","approval_status:array":"Approved","banner_image":"","calculate_demand":"No","can_self_apply":"No","created_at":"Jun 9, 2026, 5:36 AM","created_at__date":"Jun 9, 2026","created_at__time":"5:36 AM","created_at__offset":" (+00:00 UTC)","created_at__offset_minutes":0,"created_at__dayofweek":"Tuesday","feedback_form_id":null,"feedback_form_id:value":null,"feedback_form_id:array":null,"grid_image":"","headcount_functional_area_job_title_id":"Accreditation > Veterinary Technician","headcount_functional_area_job_title_id:value":1,"headcount_functional_area_job_title_id:array":"Accreditation > Veterinary Technician","headcount_location_venue_id":"Melbourne > Dot Etcher","headcount_location_venue_id:value":10,"headcount_location_venue_id:array":"Melbourne > Dot Etcher","is_refund_allowed":"No","journey_complete_status_default":null,"journey_complete_status_default:value":null,"journey_complete_status_default:array":null,"journey_id":null,"journey_id:value":null,"journey_id:array":null,"minimum_age":"","preassign_enabled":"Yes","promoted":"No","public":"No","publish":"Yes","reject_form_id":null,"reject_form_id:value":null,"reject_form_id:array":null,"tags":null,"tags:value":null,"tags:array":null,"training_ids":"Paper Goods Machine Operator_EBMsffvoa9Ht","training_ids:value":"","training_ids:array":["Paper Goods Machine Operator_EBMsffvoa9Ht"],"updated_at":"Jun 9, 2026, 5:36 AM","updated_at__date":"Jun 9, 2026","updated_at__time":"5:36 AM","updated_at__offset":" (+00:00 UTC)","updated_at__offset_minutes":0,"updated_at__dayofweek":"Tuesday","user_type_id":"Default","user_type_id:value":2,"user_type_id:array":"Default","visibility_hide_groups":"","visibility_show_groups":"","withdraw_form_id":null,"withdraw_form_id:value":null,"withdraw_form_id:array":null,"withdrawn_status_default":null,"withdrawn_status_default:value":null,"withdrawn_status_default:array":null,"account_id":20101,"account_url":"https://sub.rosterfy2.localhost.com/","confidence_level":"0%"},"relations":[],"permissions":{"read":true,"update":true,"delete":true,"accept":false,"reject":false,"withdraw":false,"apply":false,"apply_error":"Role offer not accepting applications at this time","apply_error_code":1030,"update_application_form":false}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}],"first_page_url":"https://example.rosterfy.com/api/v2/headcount/roleoffer?per_page=5&_locale=en-US&page=1","from":1,"next_page_url":"https://example.rosterfy.com/api/v2/headcount/roleoffer?per_page=5&_locale=en-US&page=2","path":"https://example.rosterfy.com/api/v2/headcount/roleoffer","per_page":5,"prev_page_url":null,"to":5}]]},"id":"schema_388"},"schema_389":{"kind":"json-schema","data":{"type":"object","properties":{"headcount_functional_area_job_title_id":{"type":"integer","description":"The job title being recruited for. A role offer is unique on the combination of job title and venue.","examples":[1]},"headcount_location_venue_id":{"type":"integer","description":"The venue the role is worked at. A role offer is unique on the combination of job title and venue.","examples":[10]},"user_type_id":{"type":"integer","description":"The type of person the role is offered to, which governs how many shifts one of them can be rostered onto.","examples":[2]},"role_offer_template_id":{"type":"integer","description":"A template to build the role offer from. The template's values are copied over anything sent alongside it, so most other fields are ignored when this is set. Create only.","examples":[1]},"description":{"type":"string","description":"Description of the role, shown to applicants in the portal. Accepts HTML.","examples":[""]},"static_demand":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of people needed. Use this when demand is set directly; it is ignored when calculate_demand is 1."},"children":[]}]}]}],"examples":[12]},"min_demand":{"type":"integer","description":"The minimum number of accepted people the role needs to be considered viable. Used for reporting; it does not stop applications.","examples":[0]},"calculate_demand":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set to 1 to derive demand from the shift pattern instead of setting it directly, in which case user_per_shift, number_of_shifts_per_day, start_date and end_date are used and static_demand is ignored. Defaults to 0."},"children":[]}]}]}],"examples":[0]},"waitlist_demand":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How many people may join a waitlist once the role is full. Send enable_waitlist alongside it on update, or the waitlist is switched off."},"children":[]}]}]}],"examples":[0]},"waitlist_auto_invitation_enabled":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set to 1 to invite waitlisted people to apply automatically as places free up. Ignored unless waitlist_demand is set."},"children":[]}]}]}],"examples":[0]},"confidence_level":{"type":"integer","description":"How far over demand the role may be filled, as a percentage between 0 and 100, to allow for people dropping out.","examples":[0]},"user_per_shift":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How many people each shift needs. Only used when calculate_demand is 1."},"children":[]}]}]}],"examples":[0]},"peak_shift":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The largest number of concurrent shifts to plan for. Only used when calculate_demand is 1."},"children":[]}]}]}],"examples":[0]},"number_of_shifts_per_day":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How many shifts run per day. Only used when calculate_demand is 1."},"children":[]}]}]}],"examples":[0]},"start_date":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"First day demand is calculated across, as YYYY-MM-DD. Only used when calculate_demand is 1."},"children":[]}]}]}],"examples":[null]},"end_date":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Last day demand is calculated across, as YYYY-MM-DD. Must not be before start_date. Only used when calculate_demand is 1."},"children":[]}]}]}],"examples":[null]},"role_feedback_form_id":{"type":"integer","description":"A form the person is offered on their dashboard once the role is complete.","examples":[1]},"secondary_assignment_demand":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How many people may take the role as a second assignment, which does not count towards the number of roles they hold. Cannot exceed the role's demand, and is ignored when calculate_demand is 1."},"children":[]}]}]}],"examples":[0]},"publish":{"type":"boolean","description":"Set to 1 to make the role offer live. An unpublished role offer is not visible to applicants.","examples":[1]},"promoted":{"type":"boolean","description":"Set to 1 to feature the role on the portal dashboard.","examples":[0]},"sort_order":{"type":"integer","description":"Position of the role in listings. Lower sorts first.","examples":[0]},"rules":{"type":"array","description":"Conditions that govern who may apply and what applying costs. Omitting this on update clears the role's existing rules. A rule missing a required part is dropped rather than rejected, so the role can come back with fewer rules than were sent.","items":{"type":"object"},"examples":[[]]},"expires_in":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How many days an unanswered offer stays open before it expires. Send expires_in_enable alongside it, or expiry is switched off and this resets to 0."},"children":[]}]}]}],"examples":[0]},"certificate_id":{"type":"integer","description":"A certificate awarded once someone completes the role.","examples":[1]},"accept_form_id":{"type":"integer","description":"A form shown when someone accepts the role.","examples":[1]},"reject_form_id":{"type":"integer","description":"A form shown when someone rejects the role.","examples":[1]},"training_ids":{"type":"array","description":"Training modules assigned to everyone who takes the role.","items":{"type":"integer"},"examples":[[1]]},"preassign_enabled":{"type":"boolean","description":"Set to 1 to allow people to be pre-assigned to the role before applications open.","examples":[1]},"banner_image":{"type":"string","description":"Banner shown at the top of the role's page. Either an uploaded image or the URL of one.","examples":[null]},"grid_image":{"type":"string","description":"Thumbnail shown wherever the role appears in a grid listing. Either an uploaded image or the URL of one.","examples":[null]},"public":{"type":"boolean","description":"Set to 1 to make the role visible without signing in, on the public listing.","examples":[0]},"can_self_apply":{"type":"boolean","description":"Set to 1 to let people apply themselves rather than having the role assigned to them. Setting it to 0 clears the role's tags.","examples":[0]},"timezone":{"type":"string","description":"The timezone the role's dates and times are interpreted in. Defaults to the account's timezone.","examples":[null]},"apps_open_timestamp":{"type":"string","description":"When applications open, as YYYY-MM-DD HH:MM:SS. Nobody can apply before it.","examples":[null]},"apps_close_timestamp":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When applications close, as YYYY-MM-DD HH:MM:SS. Nobody can apply after it, and it must be later than apps_open_timestamp."},"children":[]}]}]}],"examples":[null]},"minimum_dob":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The latest date of birth allowed, as YYYY-MM-DD. Someone born after it cannot apply from the portal. Cannot be combined with minimum_age."},"children":[]}]}]}],"examples":[null]},"minimum_age":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The youngest age allowed, as years and months separated by a colon, for example \"18:0\". Cannot be combined with minimum_dob."},"children":[]}]}]}],"examples":[null]},"maximum_dob":{"type":"string","description":"The earliest date of birth allowed, as YYYY-MM-DD. Someone born before it cannot apply from the portal.","examples":[null]},"maximum_age":{"type":"string","description":"The oldest age allowed, as years and months separated by a colon, for example \"65:0\".","examples":[null]},"applied_status_default":{"type":"integer","description":"The status given to someone when they apply for the role. Defaults to the account's applied status.","examples":[1]},"withdrawn_status_default":{"type":"integer","description":"The status given to someone when they withdraw from the role. Defaults to the account's withdrawn status.","examples":[1]},"application_form_id":{"type":"integer","description":"A form that must be completed before applying for the role.","examples":[1]},"allows_application_withdrawals":{"type":"boolean","description":"Set to 1 to let people withdraw after applying. Switched off automatically for a role that is neither part of a journey nor self-apply.","examples":[0]},"withdraw_form_id":{"type":"string","description":"A form that must be completed before withdrawing from the role.","examples":[null]},"payment":{"type":"object","description":"What applying to the role costs, and how it is charged.","properties":{},"examples":["{}"]},"is_refund_allowed":{"type":"boolean","description":"Set to 1 to permit refunds of an application fee for this role.","examples":[0]},"withdraw_close_timestamp":{"type":"string","description":"After this point people can no longer withdraw, as YYYY-MM-DD HH:MM:SS.","examples":[null]},"refund_on_application_withdraw":{"type":"boolean","description":"Set to 1 to refund the application fee automatically when someone withdraws.","examples":[0]},"refund_on_role_offer_complete":{"type":"boolean","description":"Set to 1 to refund the application fee automatically once the role is complete.","examples":[0]},"strict_applications_enabled":{"type":"boolean","description":"Set to 1 to stop accepting applications once demand is met.","examples":[0]},"reserve_demand":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How many of the places are held back rather than opened to applicants. Cannot exceed static_demand."},"children":[]}]}]}],"examples":[0]},"custom_*":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A custom attribute, named by its code - custom_shirt_size, for example. The value follows the attribute's own type, so it may be a string, a number, a boolean or a list. See the custom attributes documentation."},"children":[]}]}]}],"examples":[null]}},"required":["headcount_functional_area_job_title_id","headcount_location_venue_id","user_type_id","static_demand","publish"]},"id":"schema_389"},"schema_390":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"headcount_functional_area_job_title_id":{"type":"integer","examples":[1]},"headcount_location_venue_id":{"type":"integer","examples":[10]},"journey_id":{"type":["string","null"],"examples":[null]},"role_offer_template_id":{"type":["string","null"],"examples":[null]},"user_type_id":{"type":"integer","examples":[2]},"certificate_id":{"type":["string","null"],"examples":[null]},"static_demand":{"type":"integer","examples":[12]},"reserve_demand":{"type":"integer","examples":[0]},"waitlist_demand":{"type":"integer","examples":[0]},"confidence_level":{"type":"integer","examples":[0]},"calculate_demand":{"type":"integer","examples":[0]},"refund_on_application_withdraw":{"type":"integer","examples":[0]},"refund_on_role_offer_complete":{"type":"integer","examples":[0]},"user_per_shift":{"type":"integer","examples":[0]},"peak_shift":{"type":"integer","examples":[0]},"min_demand":{"type":"integer","examples":[0]},"number_of_shifts_per_day":{"type":"integer","examples":[0]},"min_number_shift_users":{"type":"integer","examples":[0]},"max_number_shift_users":{"type":"integer","examples":[0]},"start_date":{"type":["string","null"],"examples":[null]},"end_date":{"type":["string","null"],"examples":[null]},"role_feedback_form_id":{"type":["string","null"],"examples":[null]},"secondary_assignment_demand":{"type":"integer","examples":[0]},"rules":{"type":"array","examples":[[]]},"ranking":{"type":["string","null"],"examples":[null]},"expires_in":{"type":"integer","examples":[0]},"preassign_enabled":{"type":"integer","examples":[1]},"sort_order":{"type":"integer","examples":[0]},"accept_form_id":{"type":["string","null"],"examples":[null]},"reject_form_id":{"type":["string","null"],"examples":[null]},"training_ids":{"type":"array","items":{"type":"integer"},"examples":[[1]]},"payment":{"type":["string","null"],"examples":[null]},"publish":{"type":"integer","examples":[1]},"promoted":{"type":"integer","examples":[0]},"is_archived":{"type":"integer","examples":[0]},"is_refund_allowed":{"type":"integer","examples":[0]},"created_by":{"type":["string","null"],"examples":[null]},"grid_image":{"type":["string","null"],"examples":[null]},"banner_image":{"type":["string","null"],"examples":[null]},"public":{"type":"integer","examples":[0]},"approval_status":{"type":"string","examples":["approved"]},"approval_reason":{"type":["string","null"],"examples":[null]},"visibility_show_groups":{"type":"array","examples":[[]]},"visibility_hide_groups":{"type":"array","examples":[[]]},"can_self_apply":{"type":"integer","examples":[0]},"application_form_id":{"type":["string","null"],"examples":[null]},"withdraw_form_id":{"type":["string","null"],"examples":[null]},"allows_application_withdrawals":{"type":"integer","examples":[0]},"timezone":{"type":["string","null"],"examples":[null]},"apps_open_timestamp":{"type":["string","null"],"examples":[null]},"apps_close_timestamp":{"type":["string","null"],"examples":[null]},"withdraw_close_timestamp":{"type":["string","null"],"examples":[null]},"minimum_dob":{"type":["string","null"],"examples":[null]},"minimum_age":{"type":["string","null"],"examples":[null]},"maximum_dob":{"type":["string","null"],"examples":[null]},"maximum_age":{"type":["string","null"],"examples":[null]},"applied_status_default":{"type":["string","null"],"examples":[null]},"withdrawn_status_default":{"type":["string","null"],"examples":[null]},"journey_complete_status_default":{"type":["string","null"],"examples":[null]},"deleted_at":{"type":["string","null"],"examples":[null]},"is_erased":{"type":"integer","examples":[0]},"strict_applications_enabled":{"type":"integer","examples":[0]},"waitlist_auto_invitation_enabled":{"type":"integer","examples":[0]},"created_at":{"type":"string","examples":["2026-06-09T05:36:16.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:31.000000Z"]},"deleted_by":{"type":["string","null"],"examples":[null]},"description":{"type":"string","examples":[""]},"tags":{"type":["string","null"],"examples":[null]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:role_offer:1"]},"accept_form_id":{"type":["string","null"],"examples":[null]},"accept_form_id:value":{"type":["string","null"],"examples":[null]},"accept_form_id:array":{"type":["string","null"],"examples":[null]},"allows_application_withdrawals":{"type":"string","examples":["No"]},"application_form_id":{"type":["string","null"],"examples":[null]},"application_form_id:value":{"type":["string","null"],"examples":[null]},"application_form_id:array":{"type":["string","null"],"examples":[null]},"applied_status_default":{"type":["string","null"],"examples":[null]},"applied_status_default:value":{"type":["string","null"],"examples":[null]},"applied_status_default:array":{"type":["string","null"],"examples":[null]},"approval_status":{"type":"string","examples":["Approved"]},"approval_status:value":{"type":"string","examples":["approved"]},"approval_status:array":{"type":"string","examples":["Approved"]},"banner_image":{"type":"string","examples":[""]},"calculate_demand":{"type":"string","examples":["No"]},"can_self_apply":{"type":"string","examples":["No"]},"created_at":{"type":"string","examples":["Jun 9, 2026, 5:36 AM"]},"created_at__date":{"type":"string","examples":["Jun 9, 2026"]},"created_at__time":{"type":"string","examples":["5:36 AM"]},"created_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"created_at__offset_minutes":{"type":"integer","examples":[0]},"created_at__dayofweek":{"type":"string","examples":["Tuesday"]},"feedback_form_id":{"type":["string","null"],"examples":[null]},"feedback_form_id:value":{"type":["string","null"],"examples":[null]},"feedback_form_id:array":{"type":["string","null"],"examples":[null]},"grid_image":{"type":"string","examples":[""]},"headcount_functional_area_job_title_id":{"type":"string","examples":["Accreditation > Veterinary Technician"]},"headcount_functional_area_job_title_id:value":{"type":"integer","examples":[1]},"headcount_functional_area_job_title_id:array":{"type":"string","examples":["Accreditation > Veterinary Technician"]},"headcount_location_venue_id":{"type":"string","examples":["Melbourne > Dot Etcher"]},"headcount_location_venue_id:value":{"type":"integer","examples":[10]},"headcount_location_venue_id:array":{"type":"string","examples":["Melbourne > Dot Etcher"]},"is_refund_allowed":{"type":"string","examples":["No"]},"journey_complete_status_default":{"type":["string","null"],"examples":[null]},"journey_complete_status_default:value":{"type":["string","null"],"examples":[null]},"journey_complete_status_default:array":{"type":["string","null"],"examples":[null]},"journey_id":{"type":["string","null"],"examples":[null]},"journey_id:value":{"type":["string","null"],"examples":[null]},"journey_id:array":{"type":["string","null"],"examples":[null]},"minimum_age":{"type":"string","examples":[""]},"preassign_enabled":{"type":"string","examples":["Yes"]},"promoted":{"type":"string","examples":["No"]},"public":{"type":"string","examples":["No"]},"publish":{"type":"string","examples":["Yes"]},"reject_form_id":{"type":["string","null"],"examples":[null]},"reject_form_id:value":{"type":["string","null"],"examples":[null]},"reject_form_id:array":{"type":["string","null"],"examples":[null]},"tags":{"type":["string","null"],"examples":[null]},"tags:value":{"type":["string","null"],"examples":[null]},"tags:array":{"type":["string","null"],"examples":[null]},"training_ids":{"type":"string","examples":["Paper Goods Machine Operator_EBMsffvoa9Ht"]},"training_ids:value":{"type":"string","examples":[""]},"training_ids:array":{"type":"array","items":{"type":"string"},"examples":[["Paper Goods Machine Operator_EBMsffvoa9Ht"]]},"updated_at":{"type":"string","examples":["Jun 9, 2026, 5:36 AM"]},"updated_at__date":{"type":"string","examples":["Jun 9, 2026"]},"updated_at__time":{"type":"string","examples":["5:36 AM"]},"updated_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"updated_at__offset_minutes":{"type":"integer","examples":[0]},"updated_at__dayofweek":{"type":"string","examples":["Tuesday"]},"user_type_id":{"type":"string","examples":["Default"]},"user_type_id:value":{"type":"integer","examples":[2]},"user_type_id:array":{"type":"string","examples":["Default"]},"visibility_hide_groups":{"type":"string","examples":[""]},"visibility_show_groups":{"type":"string","examples":[""]},"withdraw_form_id":{"type":["string","null"],"examples":[null]},"withdraw_form_id:value":{"type":["string","null"],"examples":[null]},"withdraw_form_id:array":{"type":["string","null"],"examples":[null]},"withdrawn_status_default":{"type":["string","null"],"examples":[null]},"withdrawn_status_default:value":{"type":["string","null"],"examples":[null]},"withdrawn_status_default:array":{"type":["string","null"],"examples":[null]},"account_id":{"type":"integer","examples":[20101]},"account_url":{"type":"string","examples":["https://sub.rosterfy2.localhost.com/"]},"confidence_level":{"type":"string","examples":["0%"]}}},"relations":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]},"accept":{"type":"boolean","examples":[false]},"reject":{"type":"boolean","examples":[false]},"withdraw":{"type":"boolean","examples":[false]},"apply":{"type":"boolean","examples":[false]},"apply_error":{"type":"string","examples":["Role offer not accepting applications at this time"]},"apply_error_code":{"type":"integer","examples":[1030]},"update_application_form":{"type":"boolean","examples":[false]}}}},"examples":[{"object":{"id":1,"headcount_functional_area_job_title_id":1,"headcount_location_venue_id":10,"journey_id":null,"role_offer_template_id":null,"user_type_id":2,"certificate_id":null,"static_demand":12,"reserve_demand":0,"waitlist_demand":0,"confidence_level":0,"calculate_demand":0,"refund_on_application_withdraw":0,"refund_on_role_offer_complete":0,"user_per_shift":0,"peak_shift":0,"min_demand":0,"number_of_shifts_per_day":0,"min_number_shift_users":0,"max_number_shift_users":0,"start_date":null,"end_date":null,"role_feedback_form_id":null,"secondary_assignment_demand":0,"rules":[],"ranking":null,"expires_in":0,"preassign_enabled":1,"sort_order":0,"accept_form_id":null,"reject_form_id":null,"training_ids":[1],"payment":null,"publish":1,"promoted":0,"is_archived":0,"is_refund_allowed":0,"created_by":null,"grid_image":null,"banner_image":null,"public":0,"approval_status":"approved","approval_reason":null,"visibility_show_groups":[],"visibility_hide_groups":[],"can_self_apply":0,"application_form_id":null,"withdraw_form_id":null,"allows_application_withdrawals":0,"timezone":null,"apps_open_timestamp":null,"apps_close_timestamp":null,"withdraw_close_timestamp":null,"minimum_dob":null,"minimum_age":null,"maximum_dob":null,"maximum_age":null,"applied_status_default":null,"withdrawn_status_default":null,"journey_complete_status_default":null,"deleted_at":null,"is_erased":0,"strict_applications_enabled":0,"waitlist_auto_invitation_enabled":0,"created_at":"2026-06-09T05:36:16.000000Z","updated_at":"2026-06-09T05:36:31.000000Z","deleted_by":null,"description":"","tags":null},"nice":{"rrn":"rrn:local:20101:role_offer:1","accept_form_id":null,"accept_form_id:value":null,"accept_form_id:array":null,"allows_application_withdrawals":"No","application_form_id":null,"application_form_id:value":null,"application_form_id:array":null,"applied_status_default":null,"applied_status_default:value":null,"applied_status_default:array":null,"approval_status":"Approved","approval_status:value":"approved","approval_status:array":"Approved","banner_image":"","calculate_demand":"No","can_self_apply":"No","created_at":"Jun 9, 2026, 5:36 AM","created_at__date":"Jun 9, 2026","created_at__time":"5:36 AM","created_at__offset":" (+00:00 UTC)","created_at__offset_minutes":0,"created_at__dayofweek":"Tuesday","feedback_form_id":null,"feedback_form_id:value":null,"feedback_form_id:array":null,"grid_image":"","headcount_functional_area_job_title_id":"Accreditation > Veterinary Technician","headcount_functional_area_job_title_id:value":1,"headcount_functional_area_job_title_id:array":"Accreditation > Veterinary Technician","headcount_location_venue_id":"Melbourne > Dot Etcher","headcount_location_venue_id:value":10,"headcount_location_venue_id:array":"Melbourne > Dot Etcher","is_refund_allowed":"No","journey_complete_status_default":null,"journey_complete_status_default:value":null,"journey_complete_status_default:array":null,"journey_id":null,"journey_id:value":null,"journey_id:array":null,"minimum_age":"","preassign_enabled":"Yes","promoted":"No","public":"No","publish":"Yes","reject_form_id":null,"reject_form_id:value":null,"reject_form_id:array":null,"tags":null,"tags:value":null,"tags:array":null,"training_ids":"Paper Goods Machine Operator_EBMsffvoa9Ht","training_ids:value":"","training_ids:array":["Paper Goods Machine Operator_EBMsffvoa9Ht"],"updated_at":"Jun 9, 2026, 5:36 AM","updated_at__date":"Jun 9, 2026","updated_at__time":"5:36 AM","updated_at__offset":" (+00:00 UTC)","updated_at__offset_minutes":0,"updated_at__dayofweek":"Tuesday","user_type_id":"Default","user_type_id:value":2,"user_type_id:array":"Default","visibility_hide_groups":"","visibility_show_groups":"","withdraw_form_id":null,"withdraw_form_id:value":null,"withdraw_form_id:array":null,"withdrawn_status_default":null,"withdrawn_status_default:value":null,"withdrawn_status_default:array":null,"account_id":20101,"account_url":"https://sub.rosterfy2.localhost.com/","confidence_level":"0%"},"relations":[],"permissions":{"read":true,"update":true,"delete":true,"accept":false,"reject":false,"withdraw":false,"apply":false,"apply_error":"Role offer not accepting applications at this time","apply_error_code":1030,"update_application_form":false}}]},"id":"schema_390"},"schema_391":{"kind":"json-schema","data":{"type":"object","properties":{"headcount_functional_area_job_title_id":{"type":"integer","description":"The job title being recruited for. A role offer is unique on the combination of job title and venue.","examples":[1]},"headcount_location_venue_id":{"type":"integer","description":"The venue the role is worked at. A role offer is unique on the combination of job title and venue.","examples":[10]},"user_type_id":{"type":"integer","description":"The type of person the role is offered to, which governs how many shifts one of them can be rostered onto.","examples":[2]},"static_demand":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of people needed. Use this when demand is set directly; it is ignored when calculate_demand is 1."},"children":[]}]}]}],"examples":[12]},"min_demand":{"type":"integer","description":"The minimum number of accepted people the role needs to be considered viable. Used for reporting; it does not stop applications.","examples":[0]},"calculate_demand":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set to 1 to derive demand from the shift pattern instead of setting it directly, in which case user_per_shift, number_of_shifts_per_day, start_date and end_date are used and static_demand is ignored. Defaults to 0."},"children":[]}]}]}],"examples":[0]},"waitlist_demand":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How many people may join a waitlist once the role is full. Send enable_waitlist alongside it on update, or the waitlist is switched off."},"children":[]}]}]}],"examples":[0]},"waitlist_auto_invitation_enabled":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set to 1 to invite waitlisted people to apply automatically as places free up. Ignored unless waitlist_demand is set."},"children":[]}]}]}],"examples":[0]},"user_per_shift":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How many people each shift needs. Only used when calculate_demand is 1."},"children":[]}]}]}],"examples":[0]},"peak_shift":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The largest number of concurrent shifts to plan for. Only used when calculate_demand is 1."},"children":[]}]}]}],"examples":[0]},"number_of_shifts_per_day":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How many shifts run per day. Only used when calculate_demand is 1."},"children":[]}]}]}],"examples":[0]},"start_date":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"First day demand is calculated across, as YYYY-MM-DD. Only used when calculate_demand is 1."},"children":[]}]}]}],"examples":[null]},"end_date":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Last day demand is calculated across, as YYYY-MM-DD. Must not be before start_date. Only used when calculate_demand is 1."},"children":[]}]}]}],"examples":[null]},"role_feedback_form_id":{"type":"integer","description":"A form the person is offered on their dashboard once the role is complete.","examples":[1]},"publish":{"type":"boolean","description":"Set to 1 to make the role offer live. An unpublished role offer is not visible to applicants.","examples":[1]},"promoted":{"type":"boolean","description":"Set to 1 to feature the role on the portal dashboard.","examples":[0]},"secondary_assignment_demand":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How many people may take the role as a second assignment, which does not count towards the number of roles they hold. Cannot exceed the role's demand, and is ignored when calculate_demand is 1."},"children":[]}]}]}],"examples":[0]},"confidence_level":{"type":"integer","description":"How far over demand the role may be filled, as a percentage between 0 and 100, to allow for people dropping out.","examples":[0]},"rules":{"type":"array","description":"Conditions that govern who may apply and what applying costs. Omitting this on update clears the role's existing rules. A rule missing a required part is dropped rather than rejected, so the role can come back with fewer rules than were sent.","items":{"type":"object"},"examples":[[]]},"ranking":{"type":"array","description":"Ranking bands used to order applicants. Update only.","items":{"type":"object"},"examples":[[]]},"sort_order":{"type":"integer","description":"Position of the role in listings. Lower sorts first.","examples":[0]},"expires_in":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How many days an unanswered offer stays open before it expires. Send expires_in_enable alongside it, or expiry is switched off and this resets to 0."},"children":[]}]}]}],"examples":[0]},"certificate_id":{"type":"integer","description":"A certificate awarded once someone completes the role.","examples":[1]},"accept_form_id":{"type":"integer","description":"A form shown when someone accepts the role.","examples":[1]},"reject_form_id":{"type":"integer","description":"A form shown when someone rejects the role.","examples":[1]},"training_ids":{"type":"array","description":"Training modules assigned to everyone who takes the role.","items":{"type":"integer"},"examples":[[1]]},"is_archived":{"type":"string","description":"Set to 1 to archive the role offer, hiding it from the default listing without deleting it. Update only.","examples":[0]},"preassign_enabled":{"type":"boolean","description":"Set to 1 to allow people to be pre-assigned to the role before applications open.","examples":[1]},"banner_image":{"type":"string","description":"Banner shown at the top of the role's page. Either an uploaded image or the URL of one.","examples":[null]},"grid_image":{"type":"string","description":"Thumbnail shown wherever the role appears in a grid listing. Either an uploaded image or the URL of one.","examples":[null]},"public":{"type":"boolean","description":"Set to 1 to make the role visible without signing in, on the public listing.","examples":[0]},"can_self_apply":{"type":"boolean","description":"Set to 1 to let people apply themselves rather than having the role assigned to them. Setting it to 0 clears the role's tags.","examples":[0]},"timezone":{"type":"string","description":"The timezone the role's dates and times are interpreted in. Defaults to the account's timezone.","examples":[null]},"apps_open_timestamp":{"type":"string","description":"When applications open, as YYYY-MM-DD HH:MM:SS. Nobody can apply before it.","examples":[null]},"apps_close_timestamp":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When applications close, as YYYY-MM-DD HH:MM:SS. Nobody can apply after it, and it must be later than apps_open_timestamp."},"children":[]}]}]}],"examples":[null]},"minimum_dob":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The latest date of birth allowed, as YYYY-MM-DD. Someone born after it cannot apply from the portal. Cannot be combined with minimum_age."},"children":[]}]}]}],"examples":[null]},"minimum_age":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The youngest age allowed, as years and months separated by a colon, for example \"18:0\". Cannot be combined with minimum_dob."},"children":[]}]}]}],"examples":[null]},"maximum_dob":{"type":"string","description":"The earliest date of birth allowed, as YYYY-MM-DD. Someone born before it cannot apply from the portal.","examples":[null]},"maximum_age":{"type":"string","description":"The oldest age allowed, as years and months separated by a colon, for example \"65:0\".","examples":[null]},"applied_status_default":{"type":"integer","description":"The status given to someone when they apply for the role. Defaults to the account's applied status.","examples":[1]},"withdrawn_status_default":{"type":"integer","description":"The status given to someone when they withdraw from the role. Defaults to the account's withdrawn status.","examples":[1]},"application_form_id":{"type":"integer","description":"A form that must be completed before applying for the role.","examples":[1]},"approval_status":{"type":"string","description":"Where the role offer sits in the approval process. On an account that requires approval, a caller who cannot approve may only submit it for approval. Update only.","examples":["approved"]},"approval_reason":{"type":"string","description":"Note recorded against the current approval decision. Update only.","examples":[null]},"allows_application_withdrawals":{"type":"boolean","description":"Set to 1 to let people withdraw after applying. Switched off automatically for a role that is neither part of a journey nor self-apply.","examples":[0]},"withdraw_form_id":{"type":"string","description":"A form that must be completed before withdrawing from the role.","examples":[null]},"payment":{"type":"object","description":"What applying to the role costs, and how it is charged.","properties":{},"examples":["{}"]},"is_refund_allowed":{"type":"boolean","description":"Set to 1 to permit refunds of an application fee for this role.","examples":[0]},"withdraw_close_timestamp":{"type":"string","description":"After this point people can no longer withdraw, as YYYY-MM-DD HH:MM:SS.","examples":[null]},"refund_on_application_withdraw":{"type":"boolean","description":"Set to 1 to refund the application fee automatically when someone withdraws.","examples":[0]},"refund_on_role_offer_complete":{"type":"boolean","description":"Set to 1 to refund the application fee automatically once the role is complete.","examples":[0]},"strict_applications_enabled":{"type":"boolean","description":"Set to 1 to stop accepting applications once demand is met.","examples":[0]},"reserve_demand":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How many of the places are held back rather than opened to applicants. Cannot exceed static_demand."},"children":[]}]}]}],"examples":[0]},"custom_*":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A custom attribute, named by its code - custom_shirt_size, for example. The value follows the attribute's own type, so it may be a string, a number, a boolean or a list. See the custom attributes documentation."},"children":[]}]}]}],"examples":[null]}}},"id":"schema_391"},"schema_392":{"kind":"json-schema","data":{"type":"array","description":"Warning keys to acknowledge.","items":{"type":"string"},"examples":[["headcount.roleoffer.delete.demand"]]},"id":"schema_392"},"schema_393":{"kind":"json-schema","data":{"type":"array","description":"A list of extras to include in the response. These are objects or arrays that are not part of\nthe model's primary attributes, such as stats and counts.\nFor fast responses, avoid requesting them if you don't need them. ","items":{"type":"string","enum":["stats","waitlist_duration"]},"examples":[["stats"]]},"id":"schema_393"},"schema_394":{"kind":"json-schema","data":{"type":"array","description":"A list of relations to include in the response. May be single records or collections.\nIt is often more efficient to retrieve this way, to avoid follow-up API calls.","items":{"type":"string","enum":["status_log","hasManyDeepFromRelationsWithConstraints","hasOneDeepFromRelationsWithConstraints","hasManyDeepFromReverse","hasOneDeepFromReverse"]},"examples":[["status_log"]]},"id":"schema_394"},"schema_395":{"kind":"json-schema","data":{"type":"array","items":{"type":"object","properties":{"current_page":{"type":"integer","examples":[1]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"role_offer_id":{"type":"integer","examples":[1]},"user_id":{"type":"integer","examples":[1234]},"status_id":{"type":"integer","examples":[13]},"ranking":{"type":"integer","examples":[0]},"role_offer_feedback_form_completed_at":{"type":["string","null"],"examples":[null]},"secondary_assignment":{"type":"integer","examples":[0]},"expires_at":{"type":["string","null"],"examples":[null]},"feedback":{"type":["string","null"],"examples":[null]},"status_update_at":{"type":"string","examples":["2026-05-30 14:28:24"]},"application_form_completed_at":{"type":"string","examples":["2026-05-30 14:28:24"]},"application_withdrawn_at":{"type":["string","null"],"examples":[null]},"sort_order":{"type":"integer","examples":[0]},"waitlist_invitation_email_sent_at":{"type":["string","null"],"examples":[null]},"waitlist_reminder_email_sent_at":{"type":["string","null"],"examples":[null]},"is_reserved":{"type":"integer","examples":[0]},"deleted_at":{"type":["string","null"],"examples":[null]},"is_erased":{"type":"integer","examples":[0]},"created_at":{"type":"string","examples":["2026-05-30T14:28:24.000000Z"]},"updated_at":{"type":"string","examples":["2026-05-30T14:28:24.000000Z"]},"deleted_by":{"type":["string","null"],"examples":[null]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:role_offer_user:1"]},"journey_step":{"type":"string","examples":["Application review"]},"journey_step_category":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["May 30, 2026, 2:28 PM"]},"created_at__date":{"type":"string","examples":["May 30, 2026"]},"created_at__time":{"type":"string","examples":["2:28 PM"]},"created_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"created_at__offset_minutes":{"type":"integer","examples":[0]},"created_at__dayofweek":{"type":"string","examples":["Saturday"]},"feedback":{"type":"string","examples":[""]},"status_id":{"type":"string","examples":["Applied"]},"status_id:value":{"type":"integer","examples":[13]},"status_id:array":{"type":"string","examples":["Applied"]},"status_update_at":{"type":"string","examples":["May 30, 2026, 2:28 PM"]},"status_update_at__date":{"type":"string","examples":["May 30, 2026"]},"status_update_at__time":{"type":"string","examples":["2:28 PM"]},"status_update_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"status_update_at__offset_minutes":{"type":"integer","examples":[0]},"status_update_at__dayofweek":{"type":"string","examples":["Saturday"]},"updated_at":{"type":"string","examples":["May 30, 2026, 2:28 PM"]},"updated_at__date":{"type":"string","examples":["May 30, 2026"]},"updated_at__time":{"type":"string","examples":["2:28 PM"]},"updated_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"updated_at__offset_minutes":{"type":"integer","examples":[0]},"updated_at__dayofweek":{"type":"string","examples":["Saturday"]},"status":{"type":"string","examples":["Applied"]},"status_is_public":{"type":"boolean","examples":[true]},"status_type":{"type":"string","examples":["applied"]},"user_name":{"type":"string","examples":["Example Applicant"]},"has_received_invitation":{"type":"boolean","examples":[false]},"status_color":{"type":"string","examples":["#6c757d"]},"status_lightness":{"type":"integer","examples":[0]}}},"relations":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]},"status_update":{"type":"boolean","examples":[false]},"downloadCertificate":{"type":"boolean","examples":[false]}}}}},"examples":[[{"object":{"id":1,"role_offer_id":1,"user_id":1234,"status_id":13,"ranking":0,"role_offer_feedback_form_completed_at":null,"secondary_assignment":0,"expires_at":null,"feedback":null,"status_update_at":"2026-05-30 14:28:24","application_form_completed_at":"2026-05-30 14:28:24","application_withdrawn_at":null,"sort_order":0,"waitlist_invitation_email_sent_at":null,"waitlist_reminder_email_sent_at":null,"is_reserved":0,"deleted_at":null,"is_erased":0,"created_at":"2026-05-30T14:28:24.000000Z","updated_at":"2026-05-30T14:28:24.000000Z","deleted_by":null},"nice":{"rrn":"rrn:local:20101:role_offer_user:1","journey_step":"Application review","journey_step_category":null,"created_at":"May 30, 2026, 2:28 PM","created_at__date":"May 30, 2026","created_at__time":"2:28 PM","created_at__offset":" (+00:00 UTC)","created_at__offset_minutes":0,"created_at__dayofweek":"Saturday","feedback":"","status_id":"Applied","status_id:value":13,"status_id:array":"Applied","status_update_at":"May 30, 2026, 2:28 PM","status_update_at__date":"May 30, 2026","status_update_at__time":"2:28 PM","status_update_at__offset":" (+00:00 UTC)","status_update_at__offset_minutes":0,"status_update_at__dayofweek":"Saturday","updated_at":"May 30, 2026, 2:28 PM","updated_at__date":"May 30, 2026","updated_at__time":"2:28 PM","updated_at__offset":" (+00:00 UTC)","updated_at__offset_minutes":0,"updated_at__dayofweek":"Saturday","status":"Applied","status_is_public":true,"status_type":"applied","user_name":"Example Applicant","has_received_invitation":false,"status_color":"#6c757d","status_lightness":0},"relations":[],"permissions":{"read":true,"update":true,"delete":true,"status_update":false,"downloadCertificate":false}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}]]},"first_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/headcount/roleoffer/{roleoffer}/user?per_page=5&_locale=en-US&page=1"]},"from":{"type":"integer","examples":[1]},"next_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/headcount/roleoffer/{roleoffer}/user?per_page=5&_locale=en-US&page=2"]},"path":{"type":"string","examples":["https://example.rosterfy.com/api/v2/headcount/roleoffer/{roleoffer}/user"]},"per_page":{"type":"integer","examples":[5]},"prev_page_url":{"type":["string","null"],"examples":[null]},"to":{"type":"integer","examples":[5]}}},"examples":[[{"current_page":1,"data":[{"object":{"id":1,"role_offer_id":1,"user_id":1234,"status_id":13,"ranking":0,"role_offer_feedback_form_completed_at":null,"secondary_assignment":0,"expires_at":null,"feedback":null,"status_update_at":"2026-05-30 14:28:24","application_form_completed_at":"2026-05-30 14:28:24","application_withdrawn_at":null,"sort_order":0,"waitlist_invitation_email_sent_at":null,"waitlist_reminder_email_sent_at":null,"is_reserved":0,"deleted_at":null,"is_erased":0,"created_at":"2026-05-30T14:28:24.000000Z","updated_at":"2026-05-30T14:28:24.000000Z","deleted_by":null},"nice":{"rrn":"rrn:local:20101:role_offer_user:1","journey_step":"Application review","journey_step_category":null,"created_at":"May 30, 2026, 2:28 PM","created_at__date":"May 30, 2026","created_at__time":"2:28 PM","created_at__offset":" (+00:00 UTC)","created_at__offset_minutes":0,"created_at__dayofweek":"Saturday","feedback":"","status_id":"Applied","status_id:value":13,"status_id:array":"Applied","status_update_at":"May 30, 2026, 2:28 PM","status_update_at__date":"May 30, 2026","status_update_at__time":"2:28 PM","status_update_at__offset":" (+00:00 UTC)","status_update_at__offset_minutes":0,"status_update_at__dayofweek":"Saturday","updated_at":"May 30, 2026, 2:28 PM","updated_at__date":"May 30, 2026","updated_at__time":"2:28 PM","updated_at__offset":" (+00:00 UTC)","updated_at__offset_minutes":0,"updated_at__dayofweek":"Saturday","status":"Applied","status_is_public":true,"status_type":"applied","user_name":"Example Applicant","has_received_invitation":false,"status_color":"#6c757d","status_lightness":0},"relations":[],"permissions":{"read":true,"update":true,"delete":true,"status_update":false,"downloadCertificate":false}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}],"first_page_url":"https://example.rosterfy.com/api/v2/headcount/roleoffer/{roleoffer}/user?per_page=5&_locale=en-US&page=1","from":1,"next_page_url":"https://example.rosterfy.com/api/v2/headcount/roleoffer/{roleoffer}/user?per_page=5&_locale=en-US&page=2","path":"https://example.rosterfy.com/api/v2/headcount/roleoffer/{roleoffer}/user","per_page":5,"prev_page_url":null,"to":5}]]},"id":"schema_395"},"schema_396":{"kind":"json-schema","data":{"type":"object","properties":{"status_id":{"type":"integer","description":"Where the application stands. Read the available statuses, and the id of each, from the status option set - they are configured per account, so do not hard-code ids. Changing this is the main thing an update does, and it is what sets off whatever the account has configured to follow a status change. An account may also restrict which statuses can follow which, in which case a move it does not allow is refused.","examples":[13]},"user_id":{"type":"integer","description":"The user to add to the role offer. A user can hold only one live application per role offer; a second one is rejected. Cannot be changed afterwards - to move someone to a different role offer, delete this application and create another.","examples":[1234]},"secondary_assignment":{"type":"boolean","description":"Mark the application as a secondary one. Secondary applications do not count towards the limit on how many roles a person may hold, and are counted against the role offer's separate secondary allowance rather than its main demand.","examples":[0]},"is_reserved":{"type":"boolean","description":"Place the person in the role offer's reserve list, taking up one of its reserved places rather than one of its main ones. Only meaningful on a role offer that has reserved places configured; on one that does not, the request is refused because the reserve list has no room.","examples":[0]},"custom_*":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A custom attribute, named by its code - custom_shirt_size, for example. The value follows the attribute's own type, so it may be a string, a number, a boolean or a list. See the custom attributes documentation."},"children":[]}]}]}],"examples":[null]}},"required":["status_id","user_id"]},"id":"schema_396"},"schema_397":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[2]},"role_offer_id":{"type":"integer","examples":[1]},"user_id":{"type":"integer","examples":[1235]},"status_id":{"type":"integer","examples":[2]},"status_update_at":{"type":"string","examples":["2026-05-30T14:28:24.000000Z"]},"created_at":{"type":"string","examples":["2026-05-30T14:28:24.000000Z"]},"updated_at":{"type":"string","examples":["2026-05-30T14:28:24.000000Z"]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:role_offer_user:2"]},"journey_step":{"type":"string","examples":[""]},"journey_step_category":{"type":"string","examples":[""]},"created_at":{"type":"string","examples":["May 30, 2026, 2:28 PM"]},"created_at__date":{"type":"string","examples":["May 30, 2026"]},"created_at__time":{"type":"string","examples":["2:28 PM"]},"created_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"created_at__offset_minutes":{"type":"integer","examples":[0]},"created_at__dayofweek":{"type":"string","examples":["Saturday"]},"feedback":{"type":"string","examples":[""]},"status_id":{"type":"string","examples":["Pending"]},"status_id:value":{"type":"integer","examples":[2]},"status_id:array":{"type":"string","examples":["Pending"]},"status_update_at":{"type":"string","examples":["May 30, 2026, 2:28 PM"]},"status_update_at__date":{"type":"string","examples":["May 30, 2026"]},"status_update_at__time":{"type":"string","examples":["2:28 PM"]},"status_update_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"status_update_at__offset_minutes":{"type":"integer","examples":[0]},"status_update_at__dayofweek":{"type":"string","examples":["Saturday"]},"updated_at":{"type":"string","examples":["May 30, 2026, 2:28 PM"]},"updated_at__date":{"type":"string","examples":["May 30, 2026"]},"updated_at__time":{"type":"string","examples":["2:28 PM"]},"updated_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"updated_at__offset_minutes":{"type":"integer","examples":[0]},"updated_at__dayofweek":{"type":"string","examples":["Saturday"]},"status":{"type":"string","examples":["Pending"]},"status_is_public":{"type":"boolean","examples":[true]},"status_type":{"type":"string","examples":["pending"]},"user_name":{"type":"string","examples":["Example Applicant"]},"has_received_invitation":{"type":"boolean","examples":[false]},"status_color":{"type":"string","examples":["#6c757d"]},"status_lightness":{"type":"integer","examples":[0]}}},"relations":{"type":"object","properties":{}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]},"status_update":{"type":"boolean","examples":[true]},"downloadCertificate":{"type":"boolean","examples":[false]}}}},"examples":[{"object":{"id":2,"role_offer_id":1,"user_id":1235,"status_id":2,"status_update_at":"2026-05-30T14:28:24.000000Z","created_at":"2026-05-30T14:28:24.000000Z","updated_at":"2026-05-30T14:28:24.000000Z"},"nice":{"rrn":"rrn:local:20101:role_offer_user:2","journey_step":"","journey_step_category":"","created_at":"May 30, 2026, 2:28 PM","created_at__date":"May 30, 2026","created_at__time":"2:28 PM","created_at__offset":" (+00:00 UTC)","created_at__offset_minutes":0,"created_at__dayofweek":"Saturday","feedback":"","status_id":"Pending","status_id:value":2,"status_id:array":"Pending","status_update_at":"May 30, 2026, 2:28 PM","status_update_at__date":"May 30, 2026","status_update_at__time":"2:28 PM","status_update_at__offset":" (+00:00 UTC)","status_update_at__offset_minutes":0,"status_update_at__dayofweek":"Saturday","updated_at":"May 30, 2026, 2:28 PM","updated_at__date":"May 30, 2026","updated_at__time":"2:28 PM","updated_at__offset":" (+00:00 UTC)","updated_at__offset_minutes":0,"updated_at__dayofweek":"Saturday","status":"Pending","status_is_public":true,"status_type":"pending","user_name":"Example Applicant","has_received_invitation":false,"status_color":"#6c757d","status_lightness":0},"relations":{},"permissions":{"read":true,"update":true,"delete":true,"status_update":true,"downloadCertificate":false}}]},"id":"schema_397"},"schema_398":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","examples":["Role offer demand exceeded"]}},"examples":[{"message":"Role offer demand exceeded"}]},"id":"schema_398"},"schema_399":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","examples":["This will exceed the confidence level of this Role offer"]},"reference":{"type":"string","examples":["override_system_limits.headcount.roleoffer.confidence_level"]}},"examples":[{"message":"This will exceed the confidence level of this Role offer","reference":"override_system_limits.headcount.roleoffer.confidence_level"}]},"id":"schema_399"},"schema_400":{"kind":"json-schema","data":{"type":"object","properties":{"applyTo":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to add only the users named in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Any other value adds every user the caller can see, narrowed by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filter"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if one is sent. The value is not checked against a list, so a typo is accepted and treated as \"everyone\"."},"children":[]}]}]}],"examples":[null]},"selected":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The IDs of the users to add. Required in practice when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"applyTo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and ignored otherwise, but nothing validates that: omitting it still returns a queue token, and the background work then adds nobody."},"children":[]}]}]}],"items":{"type":"integer"},"examples":[[]]},"status_id":{"type":"integer","description":"The status to start each new application on. Defaults to the account's own default applied status. Not validated here, so an id that does not exist is accepted and the background work fails rather than the request.","examples":[1]}},"required":["applyTo"]},"id":"schema_400"},"schema_401":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"role_offer_id":{"type":"integer","examples":[1]},"user_id":{"type":"integer","examples":[1234]},"status_id":{"type":"integer","examples":[13]},"ranking":{"type":"integer","examples":[0]},"role_offer_feedback_form_completed_at":{"type":["string","null"],"examples":[null]},"secondary_assignment":{"type":"integer","examples":[0]},"expires_at":{"type":["string","null"],"examples":[null]},"feedback":{"type":["string","null"],"examples":[null]},"status_update_at":{"type":"string","examples":["2026-05-30 14:28:24"]},"application_form_completed_at":{"type":"string","examples":["2026-05-30 14:28:24"]},"application_withdrawn_at":{"type":["string","null"],"examples":[null]},"sort_order":{"type":"integer","examples":[0]},"waitlist_invitation_email_sent_at":{"type":["string","null"],"examples":[null]},"waitlist_reminder_email_sent_at":{"type":["string","null"],"examples":[null]},"is_reserved":{"type":"integer","examples":[0]},"deleted_at":{"type":["string","null"],"examples":[null]},"is_erased":{"type":"integer","examples":[0]},"created_at":{"type":"string","examples":["2026-05-30T14:28:24.000000Z"]},"updated_at":{"type":"string","examples":["2026-05-30T14:28:24.000000Z"]},"deleted_by":{"type":["string","null"],"examples":[null]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:role_offer_user:1"]},"journey_step":{"type":"string","examples":["Application review"]},"journey_step_category":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["May 30, 2026, 2:28 PM"]},"created_at__date":{"type":"string","examples":["May 30, 2026"]},"created_at__time":{"type":"string","examples":["2:28 PM"]},"created_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"created_at__offset_minutes":{"type":"integer","examples":[0]},"created_at__dayofweek":{"type":"string","examples":["Saturday"]},"feedback":{"type":"string","examples":[""]},"status_id":{"type":"string","examples":["Applied"]},"status_id:value":{"type":"integer","examples":[13]},"status_id:array":{"type":"string","examples":["Applied"]},"status_update_at":{"type":"string","examples":["May 30, 2026, 2:28 PM"]},"status_update_at__date":{"type":"string","examples":["May 30, 2026"]},"status_update_at__time":{"type":"string","examples":["2:28 PM"]},"status_update_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"status_update_at__offset_minutes":{"type":"integer","examples":[0]},"status_update_at__dayofweek":{"type":"string","examples":["Saturday"]},"updated_at":{"type":"string","examples":["May 30, 2026, 2:28 PM"]},"updated_at__date":{"type":"string","examples":["May 30, 2026"]},"updated_at__time":{"type":"string","examples":["2:28 PM"]},"updated_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"updated_at__offset_minutes":{"type":"integer","examples":[0]},"updated_at__dayofweek":{"type":"string","examples":["Saturday"]},"status":{"type":"string","examples":["Applied"]},"status_is_public":{"type":"boolean","examples":[true]},"status_type":{"type":"string","examples":["applied"]},"user_name":{"type":"string","examples":["Example Applicant"]},"has_received_invitation":{"type":"boolean","examples":[false]},"status_color":{"type":"string","examples":["#6c757d"]},"status_lightness":{"type":"integer","examples":[0]}}},"relations":{"type":"object","properties":{}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]},"status_update":{"type":"boolean","examples":[false]},"downloadCertificate":{"type":"boolean","examples":[false]}}}},"examples":[{"object":{"id":1,"role_offer_id":1,"user_id":1234,"status_id":13,"ranking":0,"role_offer_feedback_form_completed_at":null,"secondary_assignment":0,"expires_at":null,"feedback":null,"status_update_at":"2026-05-30 14:28:24","application_form_completed_at":"2026-05-30 14:28:24","application_withdrawn_at":null,"sort_order":0,"waitlist_invitation_email_sent_at":null,"waitlist_reminder_email_sent_at":null,"is_reserved":0,"deleted_at":null,"is_erased":0,"created_at":"2026-05-30T14:28:24.000000Z","updated_at":"2026-05-30T14:28:24.000000Z","deleted_by":null},"nice":{"rrn":"rrn:local:20101:role_offer_user:1","journey_step":"Application review","journey_step_category":null,"created_at":"May 30, 2026, 2:28 PM","created_at__date":"May 30, 2026","created_at__time":"2:28 PM","created_at__offset":" (+00:00 UTC)","created_at__offset_minutes":0,"created_at__dayofweek":"Saturday","feedback":"","status_id":"Applied","status_id:value":13,"status_id:array":"Applied","status_update_at":"May 30, 2026, 2:28 PM","status_update_at__date":"May 30, 2026","status_update_at__time":"2:28 PM","status_update_at__offset":" (+00:00 UTC)","status_update_at__offset_minutes":0,"status_update_at__dayofweek":"Saturday","updated_at":"May 30, 2026, 2:28 PM","updated_at__date":"May 30, 2026","updated_at__time":"2:28 PM","updated_at__offset":" (+00:00 UTC)","updated_at__offset_minutes":0,"updated_at__dayofweek":"Saturday","status":"Applied","status_is_public":true,"status_type":"applied","user_name":"Example Applicant","has_received_invitation":false,"status_color":"#6c757d","status_lightness":0},"relations":{},"permissions":{"read":true,"update":true,"delete":true,"status_update":false,"downloadCertificate":false}}]},"id":"schema_401"},"schema_402":{"kind":"json-schema","data":{"type":"object","properties":{"status_id":{"type":"integer","description":"Where the application stands. Read the available statuses, and the id of each, from the status option set - they are configured per account, so do not hard-code ids. Changing this is the main thing an update does, and it is what sets off whatever the account has configured to follow a status change. An account may also restrict which statuses can follow which, in which case a move it does not allow is refused.","examples":[13]},"feedback":{"type":"string","description":"Free-text note recorded against the application. Not shown to the person the application belongs to.","examples":[null]},"secondary_assignment":{"type":"boolean","description":"Mark the application as a secondary one. Secondary applications do not count towards the limit on how many roles a person may hold, and are counted against the role offer's separate secondary allowance rather than its main demand.","examples":[0]},"is_reserved":{"type":"boolean","description":"Place the person in the role offer's reserve list, taking up one of its reserved places rather than one of its main ones. Only meaningful on a role offer that has reserved places configured; on one that does not, the request is refused because the reserve list has no room.","examples":[0]},"status_type":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An alternative to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on update: send the type of the status you want - for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"accepted"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"declined"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - and it is resolved to the matching status for the account. Use it when you know the outcome you want but not the account's ids. A type that matches nothing is not reported as such; the request comes back as a 422 naming "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instead."},"children":[]}]}]}],"examples":[null]},"custom_*":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A custom attribute, named by its code - custom_shirt_size, for example. The value follows the attribute's own type, so it may be a string, a number, a boolean or a list. See the custom attributes documentation."},"children":[]}]}]}],"examples":[null]}},"required":["status_id"]},"id":"schema_402"},"schema_403":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","examples":["Cannot move between those statuses"]}},"examples":[{"message":"Cannot move between those statuses"}]},"id":"schema_403"},"schema_404":{"kind":"json-schema","data":{"type":"array","items":{"type":"object","properties":{"current_page":{"type":"integer","examples":[1]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[21476343]},"parent_id":{"type":["string","null"],"examples":[null]},"event_template_id":{"type":["string","null"],"examples":[null]},"path":{"type":"string","examples":["21476343"]},"account_id":{"type":"integer","examples":[20101]},"event_type_id":{"type":"integer","examples":[11]},"journey_id":{"type":["string","null"],"examples":[null]},"timezone":{"type":"string","examples":["UTC"]},"start_timestamp":{"type":"string","examples":["2026-09-17T05:00:00.000000Z"]},"end_timestamp":{"type":"string","examples":["2026-10-01T05:00:00.000000Z"]},"is_ongoing":{"type":"integer","examples":[0]},"apps_open_timestamp":{"type":"string","examples":["2026-05-30T05:00:00.000000Z"]},"apps_close_timestamp":{"type":["string","null"],"examples":[null]},"headcount_location_venue_id":{"type":["string","null"],"examples":[null]},"headcount_functional_area_job_title_id":{"type":["string","null"],"examples":[null]},"shift_status_default":{"type":"integer","examples":[2]},"max_shift_apps_per_user":{"type":"integer","examples":[0]},"min_shift_apps_per_user":{"type":"integer","examples":[0]},"min_shift_apps_per_shift_type":{"type":["string","null"],"examples":[null]},"max_shift_apps_per_shift_type":{"type":["string","null"],"examples":[null]},"gap_between_shifts":{"type":"integer","examples":[0]},"shift_confirmed_status_default":{"type":"integer","examples":[3]},"shift_rejected_status_default":{"type":"integer","examples":[6]},"shift_can_withdraw_default":{"type":"integer","examples":[1]},"shift_can_confirm_default":{"type":"integer","examples":[1]},"shift_can_confirm_limit":{"type":"integer","examples":[0]},"shift_can_withdraw_limit":{"type":"integer","examples":[0]},"shift_checked_in_status_default":{"type":"integer","examples":[4]},"shift_checked_out_status_default":{"type":"integer","examples":[4]},"certificate_id":{"type":["string","null"],"examples":[null]},"shift_application_form_id_default":{"type":["string","null"],"examples":[null]},"shift_withdraw_form_id_default":{"type":["string","null"],"examples":[null]},"shift_checkin_form_id_default":{"type":["string","null"],"examples":[null]},"shift_attended_form_id_default":{"type":["string","null"],"examples":[null]},"shift_checkout_form_id_default":{"type":["string","null"],"examples":[null]},"shift_leader_feedback_form_id_default":{"type":["string","null"],"examples":[null]},"shift_feedback_form_id_default":{"type":["string","null"],"examples":[null]},"shift_precheckin_form_id_default":{"type":["string","null"],"examples":[null]},"shift_default_journey_complete_status":{"type":["string","null"],"examples":[null]},"shift_default_journey_id":{"type":["string","null"],"examples":[null]},"allow_user_activities":{"type":"integer","examples":[0]},"user_activity_form_id":{"type":["string","null"],"examples":[null]},"training_ids":{"type":["string","null"],"examples":[null]},"banner_image":{"type":["string","null"],"examples":[null]},"grid_image":{"type":["string","null"],"examples":[null]},"minimum_dob":{"type":["string","null"],"examples":[null]},"minimum_age":{"type":["string","null"],"examples":[null]},"maximum_dob":{"type":["string","null"],"examples":[null]},"maximum_age":{"type":["string","null"],"examples":[null]},"visibility_show_groups":{"type":"array","examples":[[]]},"visibility_hide_groups":{"type":"array","examples":[[]]},"visibility_show_roleoffer":{"type":"array","examples":[[]]},"role_offer_address":{"type":"integer","examples":[0]},"checkin_visible_attributes":{"type":"array","examples":[[]]},"shift_filter_attributes":{"type":["string","null"],"examples":[null]},"leader_shift_filter_attributes":{"type":["string","null"],"examples":[null]},"self_checkin":{"type":"integer","examples":[0]},"self_checkin_open":{"type":"integer","examples":[1800]},"self_checkin_close":{"type":"integer","examples":[1800]},"self_checkout_close":{"type":"integer","examples":[1800]},"checkin_close_default":{"type":"integer","examples":[0]},"shift_precheckin_open_default":{"type":"integer","examples":[0]},"shift_enable_waitlist_default":{"type":"integer","examples":[0]},"geofence_checkin_limit_default":{"type":["string","null"],"examples":[null]},"max_waitlist":{"type":"integer","examples":[0]},"group_booking_ttl_default":{"type":["string","null"],"examples":[null]},"max_group_demand_default":{"type":["string","null"],"examples":[null]},"max_group_size":{"type":["string","null"],"examples":[null]},"reserved_expiry":{"type":["string","null"],"examples":[null]},"post_feedback_form":{"type":["string","null"],"examples":[null]},"post_feedback_publish_at":{"type":["string","null"],"examples":[null]},"expression_of_interest":{"type":"integer","examples":[0]},"journey_complete_status":{"type":["string","null"],"examples":[null]},"journey_apply_status":{"type":["string","null"],"examples":[null]},"expression_of_interest_form":{"type":["string","null"],"examples":[null]},"cancel_expression_of_interest_form_id":{"type":["string","null"],"examples":[null]},"eoi_demand":{"type":"integer","examples":[0]},"sort_order":{"type":"integer","examples":[0]},"is_virtual":{"type":"integer","examples":[0]},"status":{"type":"string","examples":["published"]},"approval_status":{"type":"string","examples":["approved"]},"approval_reason":{"type":["string","null"],"examples":[null]},"promoted":{"type":"integer","examples":[0]},"public":{"type":"integer","examples":[0]},"is_cancelled":{"type":"integer","examples":[0]},"is_archived":{"type":"integer","examples":[0]},"public_shift":{"type":"integer","examples":[0]},"public_shift_default":{"type":"integer","examples":[0]},"token":{"type":"string","examples":["xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"]},"certificates_awarded":{"type":"integer","examples":[0]},"created_by":{"type":["string","null"],"examples":[null]},"updated_by":{"type":["string","null"],"examples":[null]},"deleted_at":{"type":["string","null"],"examples":[null]},"is_erased":{"type":"integer","examples":[0]},"created_at":{"type":"string","examples":["2026-06-09T05:36:43.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:43.000000Z"]},"deleted_by":{"type":["string","null"],"examples":[null]},"description":{"type":"string","examples":["<p>A weekend of community events across the city.</p>"]},"name":{"type":"string","examples":["Community Festival"]},"post_feedback":{"type":"string","examples":[""]},"tags":{"type":["string","null"],"examples":[null]},"address":{"type":"object","properties":{"iso":{"type":"string","examples":["AUS"]},"region_code":{"type":"string","examples":["VIC"]},"coordinates":{"type":"object","properties":{"latitude":{"type":"string","examples":["-37.814200"]},"longitude":{"type":"string","examples":["144.963200"]}}},"street_address_1":{"type":"string","examples":["1 Example Street"]},"street_address_2":{"type":["string","null"],"examples":[null]},"street_address_3":{"type":["string","null"],"examples":[null]},"city":{"type":"string","examples":["MELBOURNE"]},"postcode":{"type":"string","examples":["3000"]},"region":{"type":"string","examples":["VIC"]},"country":{"type":"string","examples":["AU"]},"latitude":{"type":"string","examples":["-37.814200"]},"longitude":{"type":"string","examples":["144.963200"]}}}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:example:20101:event:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"]},"address":{"type":"string","examples":["1 Example Street\nMELBOURNE\nVictoria\nAustralia\n3000"]},"address_oneline":{"type":"string","examples":["1 Example Street, MELBOURNE, Victoria, Australia, 3000"]},"address.country":{"type":"string","examples":["Australia"]},"address.country:raw":{"type":"string","examples":["AUS"]},"address.city":{"type":"string","examples":["MELBOURNE"]},"address.region":{"type":"string","examples":["Victoria"]},"address.region:raw":{"type":"string","examples":["VIC"]},"address.postcode":{"type":"string","examples":["3000"]},"address.street_address_1":{"type":"string","examples":["1 Example Street"]},"address.street_address_2":{"type":["string","null"],"examples":[null]},"address.street_address_3":{"type":["string","null"],"examples":[null]},"address.latitude":{"type":"string","examples":["-37.814200"]},"address.longitude":{"type":"string","examples":["144.963200"]},"allow_user_activities":{"type":"string","examples":["No"]},"approval_status":{"type":"string","examples":["Approved"]},"approval_status:value":{"type":"string","examples":["approved"]},"approval_status:array":{"type":"string","examples":["Approved"]},"apps_open_timestamp":{"type":"string","examples":["May 30, 2026, 5:00 AM"]},"apps_open_timestamp__date":{"type":"string","examples":["May 30, 2026"]},"apps_open_timestamp__time":{"type":"string","examples":["5:00 AM"]},"apps_open_timestamp__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"apps_open_timestamp__offset_minutes":{"type":"integer","examples":[0]},"apps_open_timestamp__dayofweek":{"type":"string","examples":["Saturday"]},"cancel_expression_of_interest_form_id":{"type":["string","null"],"examples":[null]},"cancel_expression_of_interest_form_id:value":{"type":["string","null"],"examples":[null]},"cancel_expression_of_interest_form_id:array":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["Jun 9, 2026, 5:36 AM"]},"created_at__date":{"type":"string","examples":["Jun 9, 2026"]},"created_at__time":{"type":"string","examples":["5:36 AM"]},"created_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"created_at__offset_minutes":{"type":"integer","examples":[0]},"created_at__dayofweek":{"type":"string","examples":["Tuesday"]},"end_timestamp":{"type":"string","examples":["Oct 1, 2026, 5:00 AM"]},"end_timestamp__date":{"type":"string","examples":["Oct 1, 2026"]},"end_timestamp__time":{"type":"string","examples":["5:00 AM"]},"end_timestamp__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"end_timestamp__offset_minutes":{"type":"integer","examples":[0]},"end_timestamp__dayofweek":{"type":"string","examples":["Thursday"]},"event_template_id":{"type":["string","null"],"examples":[null]},"event_template_id:value":{"type":["string","null"],"examples":[null]},"event_template_id:array":{"type":["string","null"],"examples":[null]},"event_type_id":{"type":"string","examples":["ratione laborum dolor"]},"event_type_id:value":{"type":"integer","examples":[11]},"event_type_id:array":{"type":"string","examples":["ratione laborum dolor"]},"expression_of_interest":{"type":"string","examples":["No"]},"headcount_location_venue_id":{"type":["string","null"],"examples":[null]},"headcount_location_venue_id:value":{"type":["string","null"],"examples":[null]},"headcount_location_venue_id:array":{"type":["string","null"],"examples":[null]},"is_ongoing":{"type":"string","examples":["No"]},"is_virtual":{"type":"string","examples":["No"]},"name":{"type":"string","examples":["Community Festival"]},"promoted":{"type":"string","examples":["No"]},"role_offer_address":{"type":"string","examples":["No"]},"self_checkin":{"type":"string","examples":["No"]},"shift_application_form_id_default":{"type":["string","null"],"examples":[null]},"shift_application_form_id_default:value":{"type":["string","null"],"examples":[null]},"shift_application_form_id_default:array":{"type":["string","null"],"examples":[null]},"shift_attended_form_id_default":{"type":["string","null"],"examples":[null]},"shift_attended_form_id_default:value":{"type":["string","null"],"examples":[null]},"shift_attended_form_id_default:array":{"type":["string","null"],"examples":[null]},"shift_checkin_form_id_default":{"type":["string","null"],"examples":[null]},"shift_checkin_form_id_default:value":{"type":["string","null"],"examples":[null]},"shift_checkin_form_id_default:array":{"type":["string","null"],"examples":[null]},"shift_checkout_form_id_default":{"type":["string","null"],"examples":[null]},"shift_checkout_form_id_default:value":{"type":["string","null"],"examples":[null]},"shift_checkout_form_id_default:array":{"type":["string","null"],"examples":[null]},"shift_feedback_form_id_default":{"type":["string","null"],"examples":[null]},"shift_feedback_form_id_default:value":{"type":["string","null"],"examples":[null]},"shift_feedback_form_id_default:array":{"type":["string","null"],"examples":[null]},"shift_precheckin_form_id_default":{"type":["string","null"],"examples":[null]},"shift_precheckin_form_id_default:value":{"type":["string","null"],"examples":[null]},"shift_precheckin_form_id_default:array":{"type":["string","null"],"examples":[null]},"shift_withdraw_form_id_default":{"type":["string","null"],"examples":[null]},"shift_withdraw_form_id_default:value":{"type":["string","null"],"examples":[null]},"shift_withdraw_form_id_default:array":{"type":["string","null"],"examples":[null]},"start_timestamp":{"type":"string","examples":["Sep 17, 2026, 5:00 AM"]},"start_timestamp__date":{"type":"string","examples":["Sep 17, 2026"]},"start_timestamp__time":{"type":"string","examples":["5:00 AM"]},"start_timestamp__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"start_timestamp__offset_minutes":{"type":"integer","examples":[0]},"start_timestamp__dayofweek":{"type":"string","examples":["Thursday"]},"status":{"type":"string","examples":["Published"]},"status:value":{"type":"string","examples":["published"]},"status:array":{"type":"string","examples":["Published"]},"tags":{"type":["string","null"],"examples":[null]},"tags:value":{"type":["string","null"],"examples":[null]},"tags:array":{"type":["string","null"],"examples":[null]},"updated_at":{"type":"string","examples":["Jun 9, 2026, 5:36 AM"]},"updated_at__date":{"type":"string","examples":["Jun 9, 2026"]},"updated_at__time":{"type":"string","examples":["5:36 AM"]},"updated_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"updated_at__offset_minutes":{"type":"integer","examples":[0]},"updated_at__dayofweek":{"type":"string","examples":["Tuesday"]},"visibility_hide_groups":{"type":"string","examples":[""]},"visibility_show_groups":{"type":"string","examples":[""]},"visibility_show_roleoffer":{"type":"string","examples":[""]},"full_name":{"type":"string","examples":["Community Festival"]},"event_type_name":{"type":"string","examples":["ratione laborum dolor"]},"grid_list_image":{"type":["string","null"],"examples":[null]},"is_eoi_demand_met":{"type":"boolean","examples":[false]},"has_payrun":{"type":"boolean","examples":[false]},"min_shifts":{"type":"integer","examples":[0]},"post_event_feedback_form_completed_at":{"type":["string","null"],"examples":[null]},"expression_of_interest_form_completed_at":{"type":["string","null"],"examples":[null]},"expression_of_interest_form_cancelled_at":{"type":["string","null"],"examples":[null]},"account_name":{"type":"string","examples":["Example Organisation"]}}},"relations":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]},"apply":{"type":"boolean","examples":[true]},"cancel":{"type":"boolean","examples":[true]},"can_publish":{"type":"boolean","examples":[true]}}},"attributes":{"type":"array","examples":[[]]}}},"examples":[[{"object":{"id":21476343,"parent_id":null,"event_template_id":null,"path":"21476343","account_id":20101,"event_type_id":11,"journey_id":null,"timezone":"UTC","start_timestamp":"2026-09-17T05:00:00.000000Z","end_timestamp":"2026-10-01T05:00:00.000000Z","is_ongoing":0,"apps_open_timestamp":"2026-05-30T05:00:00.000000Z","apps_close_timestamp":null,"headcount_location_venue_id":null,"headcount_functional_area_job_title_id":null,"shift_status_default":2,"max_shift_apps_per_user":0,"min_shift_apps_per_user":0,"min_shift_apps_per_shift_type":null,"max_shift_apps_per_shift_type":null,"gap_between_shifts":0,"shift_confirmed_status_default":3,"shift_rejected_status_default":6,"shift_can_withdraw_default":1,"shift_can_confirm_default":1,"shift_can_confirm_limit":0,"shift_can_withdraw_limit":0,"shift_checked_in_status_default":4,"shift_checked_out_status_default":4,"certificate_id":null,"shift_application_form_id_default":null,"shift_withdraw_form_id_default":null,"shift_checkin_form_id_default":null,"shift_attended_form_id_default":null,"shift_checkout_form_id_default":null,"shift_leader_feedback_form_id_default":null,"shift_feedback_form_id_default":null,"shift_precheckin_form_id_default":null,"shift_default_journey_complete_status":null,"shift_default_journey_id":null,"allow_user_activities":0,"user_activity_form_id":null,"training_ids":null,"banner_image":null,"grid_image":null,"minimum_dob":null,"minimum_age":null,"maximum_dob":null,"maximum_age":null,"visibility_show_groups":[],"visibility_hide_groups":[],"visibility_show_roleoffer":[],"role_offer_address":0,"checkin_visible_attributes":[],"shift_filter_attributes":null,"leader_shift_filter_attributes":null,"self_checkin":0,"self_checkin_open":1800,"self_checkin_close":1800,"self_checkout_close":1800,"checkin_close_default":0,"shift_precheckin_open_default":0,"shift_enable_waitlist_default":0,"geofence_checkin_limit_default":null,"max_waitlist":0,"group_booking_ttl_default":null,"max_group_demand_default":null,"max_group_size":null,"reserved_expiry":null,"post_feedback_form":null,"post_feedback_publish_at":null,"expression_of_interest":0,"journey_complete_status":null,"journey_apply_status":null,"expression_of_interest_form":null,"cancel_expression_of_interest_form_id":null,"eoi_demand":0,"sort_order":0,"is_virtual":0,"status":"published","approval_status":"approved","approval_reason":null,"promoted":0,"public":0,"is_cancelled":0,"is_archived":0,"public_shift":0,"public_shift_default":0,"token":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","certificates_awarded":0,"created_by":null,"updated_by":null,"deleted_at":null,"is_erased":0,"created_at":"2026-06-09T05:36:43.000000Z","updated_at":"2026-06-09T05:36:43.000000Z","deleted_by":null,"description":"<p>A weekend of community events across the city.</p>","name":"Community Festival","post_feedback":"","tags":null,"address":{"iso":"AUS","region_code":"VIC","coordinates":{"latitude":"-37.814200","longitude":"144.963200"},"street_address_1":"1 Example Street","street_address_2":null,"street_address_3":null,"city":"MELBOURNE","postcode":"3000","region":"VIC","country":"AU","latitude":"-37.814200","longitude":"144.963200"}},"nice":{"rrn":"rrn:example:20101:event:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","address":"1 Example Street\nMELBOURNE\nVictoria\nAustralia\n3000","address_oneline":"1 Example Street, MELBOURNE, Victoria, Australia, 3000","address.country":"Australia","address.country:raw":"AUS","address.city":"MELBOURNE","address.region":"Victoria","address.region:raw":"VIC","address.postcode":"3000","address.street_address_1":"1 Example Street","address.street_address_2":null,"address.street_address_3":null,"address.latitude":"-37.814200","address.longitude":"144.963200","allow_user_activities":"No","approval_status":"Approved","approval_status:value":"approved","approval_status:array":"Approved","apps_open_timestamp":"May 30, 2026, 5:00 AM","apps_open_timestamp__date":"May 30, 2026","apps_open_timestamp__time":"5:00 AM","apps_open_timestamp__offset":" (+00:00 UTC)","apps_open_timestamp__offset_minutes":0,"apps_open_timestamp__dayofweek":"Saturday","cancel_expression_of_interest_form_id":null,"cancel_expression_of_interest_form_id:value":null,"cancel_expression_of_interest_form_id:array":null,"created_at":"Jun 9, 2026, 5:36 AM","created_at__date":"Jun 9, 2026","created_at__time":"5:36 AM","created_at__offset":" (+00:00 UTC)","created_at__offset_minutes":0,"created_at__dayofweek":"Tuesday","end_timestamp":"Oct 1, 2026, 5:00 AM","end_timestamp__date":"Oct 1, 2026","end_timestamp__time":"5:00 AM","end_timestamp__offset":" (+00:00 UTC)","end_timestamp__offset_minutes":0,"end_timestamp__dayofweek":"Thursday","event_template_id":null,"event_template_id:value":null,"event_template_id:array":null,"event_type_id":"ratione laborum dolor","event_type_id:value":11,"event_type_id:array":"ratione laborum dolor","expression_of_interest":"No","headcount_location_venue_id":null,"headcount_location_venue_id:value":null,"headcount_location_venue_id:array":null,"is_ongoing":"No","is_virtual":"No","name":"Community Festival","promoted":"No","role_offer_address":"No","self_checkin":"No","shift_application_form_id_default":null,"shift_application_form_id_default:value":null,"shift_application_form_id_default:array":null,"shift_attended_form_id_default":null,"shift_attended_form_id_default:value":null,"shift_attended_form_id_default:array":null,"shift_checkin_form_id_default":null,"shift_checkin_form_id_default:value":null,"shift_checkin_form_id_default:array":null,"shift_checkout_form_id_default":null,"shift_checkout_form_id_default:value":null,"shift_checkout_form_id_default:array":null,"shift_feedback_form_id_default":null,"shift_feedback_form_id_default:value":null,"shift_feedback_form_id_default:array":null,"shift_precheckin_form_id_default":null,"shift_precheckin_form_id_default:value":null,"shift_precheckin_form_id_default:array":null,"shift_withdraw_form_id_default":null,"shift_withdraw_form_id_default:value":null,"shift_withdraw_form_id_default:array":null,"start_timestamp":"Sep 17, 2026, 5:00 AM","start_timestamp__date":"Sep 17, 2026","start_timestamp__time":"5:00 AM","start_timestamp__offset":" (+00:00 UTC)","start_timestamp__offset_minutes":0,"start_timestamp__dayofweek":"Thursday","status":"Published","status:value":"published","status:array":"Published","tags":null,"tags:value":null,"tags:array":null,"updated_at":"Jun 9, 2026, 5:36 AM","updated_at__date":"Jun 9, 2026","updated_at__time":"5:36 AM","updated_at__offset":" (+00:00 UTC)","updated_at__offset_minutes":0,"updated_at__dayofweek":"Tuesday","visibility_hide_groups":"","visibility_show_groups":"","visibility_show_roleoffer":"","full_name":"Community Festival","event_type_name":"ratione laborum dolor","grid_list_image":null,"is_eoi_demand_met":false,"has_payrun":false,"min_shifts":0,"post_event_feedback_form_completed_at":null,"expression_of_interest_form_completed_at":null,"expression_of_interest_form_cancelled_at":null,"account_name":"Example Organisation"},"relations":[],"permissions":{"read":true,"update":true,"delete":true,"apply":true,"cancel":true,"can_publish":true},"attributes":[]},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}]]},"first_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/event?per_page=5&_locale=en-US&page=1"]},"from":{"type":"integer","examples":[1]},"next_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/event?per_page=5&_locale=en-US&page=2"]},"path":{"type":"string","examples":["https://example.rosterfy.com/api/v2/event"]},"per_page":{"type":"integer","examples":[5]},"prev_page_url":{"type":["string","null"],"examples":[null]},"to":{"type":"integer","examples":[5]}}},"examples":[[{"current_page":1,"data":[{"object":{"id":21476343,"parent_id":null,"event_template_id":null,"path":"21476343","account_id":20101,"event_type_id":11,"journey_id":null,"timezone":"UTC","start_timestamp":"2026-09-17T05:00:00.000000Z","end_timestamp":"2026-10-01T05:00:00.000000Z","is_ongoing":0,"apps_open_timestamp":"2026-05-30T05:00:00.000000Z","apps_close_timestamp":null,"headcount_location_venue_id":null,"headcount_functional_area_job_title_id":null,"shift_status_default":2,"max_shift_apps_per_user":0,"min_shift_apps_per_user":0,"min_shift_apps_per_shift_type":null,"max_shift_apps_per_shift_type":null,"gap_between_shifts":0,"shift_confirmed_status_default":3,"shift_rejected_status_default":6,"shift_can_withdraw_default":1,"shift_can_confirm_default":1,"shift_can_confirm_limit":0,"shift_can_withdraw_limit":0,"shift_checked_in_status_default":4,"shift_checked_out_status_default":4,"certificate_id":null,"shift_application_form_id_default":null,"shift_withdraw_form_id_default":null,"shift_checkin_form_id_default":null,"shift_attended_form_id_default":null,"shift_checkout_form_id_default":null,"shift_leader_feedback_form_id_default":null,"shift_feedback_form_id_default":null,"shift_precheckin_form_id_default":null,"shift_default_journey_complete_status":null,"shift_default_journey_id":null,"allow_user_activities":0,"user_activity_form_id":null,"training_ids":null,"banner_image":null,"grid_image":null,"minimum_dob":null,"minimum_age":null,"maximum_dob":null,"maximum_age":null,"visibility_show_groups":[],"visibility_hide_groups":[],"visibility_show_roleoffer":[],"role_offer_address":0,"checkin_visible_attributes":[],"shift_filter_attributes":null,"leader_shift_filter_attributes":null,"self_checkin":0,"self_checkin_open":1800,"self_checkin_close":1800,"self_checkout_close":1800,"checkin_close_default":0,"shift_precheckin_open_default":0,"shift_enable_waitlist_default":0,"geofence_checkin_limit_default":null,"max_waitlist":0,"group_booking_ttl_default":null,"max_group_demand_default":null,"max_group_size":null,"reserved_expiry":null,"post_feedback_form":null,"post_feedback_publish_at":null,"expression_of_interest":0,"journey_complete_status":null,"journey_apply_status":null,"expression_of_interest_form":null,"cancel_expression_of_interest_form_id":null,"eoi_demand":0,"sort_order":0,"is_virtual":0,"status":"published","approval_status":"approved","approval_reason":null,"promoted":0,"public":0,"is_cancelled":0,"is_archived":0,"public_shift":0,"public_shift_default":0,"token":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","certificates_awarded":0,"created_by":null,"updated_by":null,"deleted_at":null,"is_erased":0,"created_at":"2026-06-09T05:36:43.000000Z","updated_at":"2026-06-09T05:36:43.000000Z","deleted_by":null,"description":"<p>A weekend of community events across the city.</p>","name":"Community Festival","post_feedback":"","tags":null,"address":{"iso":"AUS","region_code":"VIC","coordinates":{"latitude":"-37.814200","longitude":"144.963200"},"street_address_1":"1 Example Street","street_address_2":null,"street_address_3":null,"city":"MELBOURNE","postcode":"3000","region":"VIC","country":"AU","latitude":"-37.814200","longitude":"144.963200"}},"nice":{"rrn":"rrn:example:20101:event:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","address":"1 Example Street\nMELBOURNE\nVictoria\nAustralia\n3000","address_oneline":"1 Example Street, MELBOURNE, Victoria, Australia, 3000","address.country":"Australia","address.country:raw":"AUS","address.city":"MELBOURNE","address.region":"Victoria","address.region:raw":"VIC","address.postcode":"3000","address.street_address_1":"1 Example Street","address.street_address_2":null,"address.street_address_3":null,"address.latitude":"-37.814200","address.longitude":"144.963200","allow_user_activities":"No","approval_status":"Approved","approval_status:value":"approved","approval_status:array":"Approved","apps_open_timestamp":"May 30, 2026, 5:00 AM","apps_open_timestamp__date":"May 30, 2026","apps_open_timestamp__time":"5:00 AM","apps_open_timestamp__offset":" (+00:00 UTC)","apps_open_timestamp__offset_minutes":0,"apps_open_timestamp__dayofweek":"Saturday","cancel_expression_of_interest_form_id":null,"cancel_expression_of_interest_form_id:value":null,"cancel_expression_of_interest_form_id:array":null,"created_at":"Jun 9, 2026, 5:36 AM","created_at__date":"Jun 9, 2026","created_at__time":"5:36 AM","created_at__offset":" (+00:00 UTC)","created_at__offset_minutes":0,"created_at__dayofweek":"Tuesday","end_timestamp":"Oct 1, 2026, 5:00 AM","end_timestamp__date":"Oct 1, 2026","end_timestamp__time":"5:00 AM","end_timestamp__offset":" (+00:00 UTC)","end_timestamp__offset_minutes":0,"end_timestamp__dayofweek":"Thursday","event_template_id":null,"event_template_id:value":null,"event_template_id:array":null,"event_type_id":"ratione laborum dolor","event_type_id:value":11,"event_type_id:array":"ratione laborum dolor","expression_of_interest":"No","headcount_location_venue_id":null,"headcount_location_venue_id:value":null,"headcount_location_venue_id:array":null,"is_ongoing":"No","is_virtual":"No","name":"Community Festival","promoted":"No","role_offer_address":"No","self_checkin":"No","shift_application_form_id_default":null,"shift_application_form_id_default:value":null,"shift_application_form_id_default:array":null,"shift_attended_form_id_default":null,"shift_attended_form_id_default:value":null,"shift_attended_form_id_default:array":null,"shift_checkin_form_id_default":null,"shift_checkin_form_id_default:value":null,"shift_checkin_form_id_default:array":null,"shift_checkout_form_id_default":null,"shift_checkout_form_id_default:value":null,"shift_checkout_form_id_default:array":null,"shift_feedback_form_id_default":null,"shift_feedback_form_id_default:value":null,"shift_feedback_form_id_default:array":null,"shift_precheckin_form_id_default":null,"shift_precheckin_form_id_default:value":null,"shift_precheckin_form_id_default:array":null,"shift_withdraw_form_id_default":null,"shift_withdraw_form_id_default:value":null,"shift_withdraw_form_id_default:array":null,"start_timestamp":"Sep 17, 2026, 5:00 AM","start_timestamp__date":"Sep 17, 2026","start_timestamp__time":"5:00 AM","start_timestamp__offset":" (+00:00 UTC)","start_timestamp__offset_minutes":0,"start_timestamp__dayofweek":"Thursday","status":"Published","status:value":"published","status:array":"Published","tags":null,"tags:value":null,"tags:array":null,"updated_at":"Jun 9, 2026, 5:36 AM","updated_at__date":"Jun 9, 2026","updated_at__time":"5:36 AM","updated_at__offset":" (+00:00 UTC)","updated_at__offset_minutes":0,"updated_at__dayofweek":"Tuesday","visibility_hide_groups":"","visibility_show_groups":"","visibility_show_roleoffer":"","full_name":"Community Festival","event_type_name":"ratione laborum dolor","grid_list_image":null,"is_eoi_demand_met":false,"has_payrun":false,"min_shifts":0,"post_event_feedback_form_completed_at":null,"expression_of_interest_form_completed_at":null,"expression_of_interest_form_cancelled_at":null,"account_name":"Example Organisation"},"relations":[],"permissions":{"read":true,"update":true,"delete":true,"apply":true,"cancel":true,"can_publish":true},"attributes":[]},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}],"first_page_url":"https://example.rosterfy.com/api/v2/event?per_page=5&_locale=en-US&page=1","from":1,"next_page_url":"https://example.rosterfy.com/api/v2/event?per_page=5&_locale=en-US&page=2","path":"https://example.rosterfy.com/api/v2/event","per_page":5,"prev_page_url":null,"to":5}]]},"id":"schema_404"},"schema_405":{"kind":"json-schema","data":{"type":"object","properties":{"event_template_id":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The template to build the event from. Its values are applied over whatever else you send. Send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_template"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to start from nothing instead. Where the account has templates configured, one of the two is expected."},"children":[]}]}]}],"examples":[1]},"name":{"type":"string","description":"What the event is called. Shown to everyone who can see the event.","examples":["Community Festival"]},"event_type_id":{"type":"integer","description":"Which of the account's event types this is. Defaults to the account's first type when left out.","examples":[11]},"description":{"type":"string","description":"The event's description, as HTML. Shown on the event's page in the portal.","examples":["<p>A weekend of community events across the city.</p>"]},"timezone":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The timezone every timestamp on the event is given in, as an IANA name such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Australia/Melbourne"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Defaults to the account's timezone."},"children":[]}]}]}],"examples":["UTC"]},"start_timestamp":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the event starts, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD HH:MM:SS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the event's timezone. Required when the event is not ongoing. Cleared if you mark the event ongoing."},"children":[]}]}]}],"examples":["2026-09-17T05:00:00.000000Z"]},"end_timestamp":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the event ends, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD HH:MM:SS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the event's timezone. Defaults to the start when the event is not ongoing. Cleared if you mark the event ongoing."},"children":[]}]}]}],"examples":["2026-10-01T05:00:00.000000Z"]},"is_virtual":{"type":"boolean","description":"Whether the event has no physical location. A virtual event needs neither an address nor a venue.","examples":[0]},"shift_status_default":{"type":"integer","description":"The status a new application to a shift on this event starts in. Defaults to the account's.","examples":[2]},"shift_confirmed_status_default":{"type":"integer","description":"The status applied when someone confirms their place on a shift. Defaults to the account's.","examples":[3]},"shift_rejected_status_default":{"type":"integer","description":"The status applied when someone is turned down for a shift. Defaults to the account's.","examples":[6]},"shift_can_withdraw_default":{"type":"boolean","description":"Whether people may withdraw from this event's shifts.","examples":[1]},"shift_can_confirm_default":{"type":"boolean","description":"Whether people are asked to confirm their place on this event's shifts.","examples":[1]},"shift_can_withdraw_limit":{"type":"integer","description":"How long before a shift starts withdrawing stops being allowed, in seconds.","examples":[0]},"shift_can_confirm_limit":{"type":"integer","description":"How long before a shift starts confirming stops being allowed, in seconds.","examples":[0]},"shift_checked_in_status_default":{"type":"integer","description":"The status applied when someone checks in to a shift. Defaults to the account's.","examples":[4]},"shift_checked_out_status_default":{"type":"integer","description":"The status applied when someone checks out of a shift. Defaults to the account's.","examples":[4]},"apps_open_timestamp":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When applications open, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD HH:MM:SS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the event's timezone. Leave empty for applications that are open from the start."},"children":[]}]}]}],"examples":["2026-05-30T05:00:00.000000Z"]},"apps_close_timestamp":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When applications close, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD HH:MM:SS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the event's timezone. Must be after "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"apps_open_timestamp"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"max_shift_apps_per_user":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The most shifts on this event one person may hold. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" means no limit."},"children":[]}]}]}],"examples":[0]},"min_shift_apps_per_user":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The fewest shifts on this event one person is expected to hold. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" means no minimum."},"children":[]}]}]}],"examples":[0]},"min_shift_apps_per_shift_type":{"type":"object","description":"Per-shift-type minimums, as an object keyed by shift type id.","properties":{},"examples":["{}"]},"max_shift_apps_per_shift_type":{"type":"object","description":"Per-shift-type ceilings, as an object keyed by shift type id.","properties":{},"examples":["{}"]},"gap_between_shifts":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The rest required between two shifts on this event, in seconds. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" means none."},"children":[]}]}]}],"examples":[0]},"role_offer_address":{"type":"boolean","description":"Whether the event takes its location from the role offer people applied through rather than from its own address.","examples":[0]},"status":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether the event is visible to people who can apply: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"published"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"unpublished"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"auto_publish"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"submit_for_approval"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rejected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". New events start unpublished."},"children":[]}]}]}],"examples":["published"]},"parent_id":{"type":"integer","description":"The id of the event this one sits beneath, for accounts that group events into a parent and its sub-events.","examples":[1]},"address":{"type":"object","description":"Where the event takes place. Required unless the event is virtual or is held at a venue.","properties":{},"examples":[{"iso":"AUS","region_code":"VIC","coordinates":{"latitude":"-37.814200","longitude":"144.963200"},"street_address_1":"1 Example Street","street_address_2":null,"street_address_3":null,"city":"MELBOURNE","postcode":"3000","region":"VIC","country":"AU","latitude":"-37.814200","longitude":"144.963200"}]},"headcount_location_venue_id":{"type":"integer","description":"The venue the event is held at, instead of an address of its own.","examples":[1]},"headcount_functional_area_job_title_id":{"type":"integer","description":"The job title this event's work is counted against for workforce planning.","examples":[1]},"certificate_id":{"type":"integer","description":"The certificate awarded for taking part in this event.","examples":[1]},"visibility_show_groups":{"type":"array","description":"Restrict the event to these groups, as a list of group ids. An empty list shows it to everyone.","items":{"type":"integer"},"examples":[[]]},"visibility_hide_groups":{"type":"array","description":"Hide the event from these groups, as a list of group ids.","items":{"type":"integer"},"examples":[[]]},"visibility_show_roleoffer":{"type":"array","description":"Restrict the event to people who came through these role offers, as a list of role offer ids.","items":{"type":"integer"},"examples":[[]]},"shift_application_form_id_default":{"type":"integer","description":"The form filled in when applying for one of this event's shifts.","examples":[1]},"shift_precheckin_form_id_default":{"type":"integer","description":"The form filled in before checking in to one of this event's shifts.","examples":[1]},"shift_checkin_form_id_default":{"type":"integer","description":"The form filled in at check-in.","examples":[1]},"shift_attended_form_id_default":{"type":"integer","description":"The form filled in once attendance is recorded.","examples":[1]},"shift_checkout_form_id_default":{"type":"integer","description":"The form filled in at check-out.","examples":[1]},"shift_feedback_form_id_default":{"type":"integer","description":"The feedback form offered after one of this event's shifts.","examples":[1]},"shift_leader_feedback_form_id_default":{"type":"integer","description":"The feedback form a shift leader is asked to fill in.","examples":[1]},"shift_precheckin_open_default":{"type":"integer","description":"How long before a shift starts its pre-check-in form becomes available, in seconds.","examples":[0]},"max_group_demand_default":{"type":"integer","description":"The most places a group leader may reserve on one of this event's shifts.","examples":[1]},"group_booking_ttl_default":{"type":"integer","description":"How long a group leader's reserved places are held before they are released, in seconds.","examples":[1]},"geofence_checkin_limit_default":{"type":"integer","description":"How close to the shift's location someone must be to check in, in metres. Empty means no limit.","examples":[1]},"self_checkin":{"type":"boolean","description":"Whether people may check themselves in to this event's shifts.","examples":[0]},"self_checkin_open":{"type":"integer","description":"How long before a shift starts self check-in opens, in seconds.","examples":[1800]},"self_checkin_close":{"type":"integer","description":"How long after a shift starts self check-in closes, in seconds.","examples":[1800]},"self_checkout_close":{"type":"integer","description":"How long after a shift ends self check-out closes, in seconds.","examples":[1800]},"checkin_close_default":{"type":"integer","description":"How long after a shift ends check-in closes, in seconds.","examples":[0]},"checkin_visible_attributes":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Which fields are shown on the check-in page, as a list of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"<entity>.<attribute>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" names such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user.first_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"items":{"type":"string"},"examples":[[]]},"shift_filter_attributes":{"type":"array","description":"Which attributes people may filter this event's shifts by, as a list of attribute ids.","items":{"type":"integer"},"examples":[[]]},"leader_shift_filter_attributes":{"type":"array","description":"Which attributes a shift leader may filter by, as a list of attribute ids.","items":{"type":"integer"},"examples":[[]]},"post_feedback":{"type":"string","description":"The message shown once the post-event feedback form is available, as HTML.","examples":[""]},"post_feedback_publish_at":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the post-event feedback form becomes available, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD HH:MM:SS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"training_ids":{"type":"array","description":"The training people must have completed before they can apply, as a list of training ids.","items":{"type":"integer"},"examples":[[]]},"banner_image":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The event's banner image. Send the URL of an image already uploaded through Rosterfy, or the image itself as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"multipart/form-data"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A URL on any other host is rejected."},"children":[]}]}]}],"examples":[null]},"grid_image":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The image shown for the event in listings. Same accepted values as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"banner_image"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"mobile_banner_image":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The banner image used on smaller screens. Same accepted values as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"banner_image"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"minimum_dob":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The latest date of birth allowed, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Cannot be combined with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"minimum_age"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"minimum_age":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The youngest age allowed, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"years:months"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"16:0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Cannot be combined with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"minimum_dob"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"maximum_dob":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The earliest date of birth allowed, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Cannot be combined with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"maximum_age"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"maximum_age":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The oldest age allowed, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"years:months"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Cannot be combined with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"maximum_dob"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"public":{"type":"boolean","description":"Whether the event is visible to people who are not signed in, on accounts that allow public browsing.","examples":[0]},"public_shift":{"type":"boolean","description":"Whether this event's shifts are visible to people who are not signed in.","examples":[0]},"public_shift_default":{"type":"boolean","description":"Whether a newly created shift on this event is public by default.","examples":[0]},"token":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The event's public reference, the last part of its "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rrn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Generated when the event is created; there is rarely a reason to set your own."},"children":[]}]}]}],"examples":["xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"]},"expression_of_interest":{"type":"boolean","description":"Whether people may register interest in the event without applying for a specific shift.","examples":[0]},"expression_of_interest_form":{"type":"integer","description":"The form filled in when registering interest.","examples":[1]},"shift_enable_waitlist_default":{"type":"boolean","description":"Whether a full shift on this event takes a waitlist.","examples":[0]},"max_waitlist":{"type":"integer","description":"How many people a shift's waitlist holds.","examples":[0]},"allow_user_activities":{"type":"boolean","description":"Whether people may log their own activity against this event.","examples":[0]},"user_activity_form_id":{"type":"integer","description":"The form used to log that activity.","examples":[1]},"approval_status":{"type":"string","description":"Where the event sits in the account's approval process, when the account requires events to be approved.","examples":["approved"]},"approval_reason":{"type":"string","description":"Free text explaining the approval decision.","examples":[null]},"is_ongoing":{"type":"boolean","description":"Whether the event runs indefinitely rather than between two dates. Setting it clears the start and end.","examples":[0]},"sort_order":{"type":"integer","description":"Where the event sits when events are ordered manually. Lower comes first.","examples":[0]},"custom_*":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A custom attribute, named by its code - custom_shirt_size, for example. The value follows the attribute's own type, so it may be a string, a number, a boolean or a list. See the custom attributes documentation."},"children":[]}]}]}],"examples":[null]}},"required":["name","description"]},"id":"schema_405"},"schema_406":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[21476343]},"parent_id":{"type":["string","null"],"examples":[null]},"event_template_id":{"type":["string","null"],"examples":[null]},"path":{"type":"string","examples":["21476343"]},"account_id":{"type":"integer","examples":[20101]},"event_type_id":{"type":"integer","examples":[11]},"journey_id":{"type":["string","null"],"examples":[null]},"timezone":{"type":"string","examples":["UTC"]},"start_timestamp":{"type":"string","examples":["2026-09-17T05:00:00.000000Z"]},"end_timestamp":{"type":"string","examples":["2026-10-01T05:00:00.000000Z"]},"is_ongoing":{"type":"integer","examples":[0]},"apps_open_timestamp":{"type":"string","examples":["2026-05-30T05:00:00.000000Z"]},"apps_close_timestamp":{"type":["string","null"],"examples":[null]},"headcount_location_venue_id":{"type":["string","null"],"examples":[null]},"headcount_functional_area_job_title_id":{"type":["string","null"],"examples":[null]},"shift_status_default":{"type":"integer","examples":[2]},"max_shift_apps_per_user":{"type":"integer","examples":[0]},"min_shift_apps_per_user":{"type":"integer","examples":[0]},"min_shift_apps_per_shift_type":{"type":["string","null"],"examples":[null]},"max_shift_apps_per_shift_type":{"type":["string","null"],"examples":[null]},"gap_between_shifts":{"type":"integer","examples":[0]},"shift_confirmed_status_default":{"type":"integer","examples":[3]},"shift_rejected_status_default":{"type":"integer","examples":[6]},"shift_can_withdraw_default":{"type":"integer","examples":[1]},"shift_can_confirm_default":{"type":"integer","examples":[1]},"shift_can_confirm_limit":{"type":"integer","examples":[0]},"shift_can_withdraw_limit":{"type":"integer","examples":[0]},"shift_checked_in_status_default":{"type":"integer","examples":[4]},"shift_checked_out_status_default":{"type":"integer","examples":[4]},"certificate_id":{"type":["string","null"],"examples":[null]},"shift_application_form_id_default":{"type":["string","null"],"examples":[null]},"shift_withdraw_form_id_default":{"type":["string","null"],"examples":[null]},"shift_checkin_form_id_default":{"type":["string","null"],"examples":[null]},"shift_attended_form_id_default":{"type":["string","null"],"examples":[null]},"shift_checkout_form_id_default":{"type":["string","null"],"examples":[null]},"shift_leader_feedback_form_id_default":{"type":["string","null"],"examples":[null]},"shift_feedback_form_id_default":{"type":["string","null"],"examples":[null]},"shift_precheckin_form_id_default":{"type":["string","null"],"examples":[null]},"shift_default_journey_complete_status":{"type":["string","null"],"examples":[null]},"shift_default_journey_id":{"type":["string","null"],"examples":[null]},"allow_user_activities":{"type":"integer","examples":[0]},"user_activity_form_id":{"type":["string","null"],"examples":[null]},"training_ids":{"type":["string","null"],"examples":[null]},"banner_image":{"type":["string","null"],"examples":[null]},"grid_image":{"type":["string","null"],"examples":[null]},"minimum_dob":{"type":["string","null"],"examples":[null]},"minimum_age":{"type":["string","null"],"examples":[null]},"maximum_dob":{"type":["string","null"],"examples":[null]},"maximum_age":{"type":["string","null"],"examples":[null]},"visibility_show_groups":{"type":"array","examples":[[]]},"visibility_hide_groups":{"type":"array","examples":[[]]},"visibility_show_roleoffer":{"type":"array","examples":[[]]},"role_offer_address":{"type":"integer","examples":[0]},"checkin_visible_attributes":{"type":"array","examples":[[]]},"shift_filter_attributes":{"type":["string","null"],"examples":[null]},"leader_shift_filter_attributes":{"type":["string","null"],"examples":[null]},"self_checkin":{"type":"integer","examples":[0]},"self_checkin_open":{"type":"integer","examples":[1800]},"self_checkin_close":{"type":"integer","examples":[1800]},"self_checkout_close":{"type":"integer","examples":[1800]},"checkin_close_default":{"type":"integer","examples":[0]},"shift_precheckin_open_default":{"type":"integer","examples":[0]},"shift_enable_waitlist_default":{"type":"integer","examples":[0]},"geofence_checkin_limit_default":{"type":["string","null"],"examples":[null]},"max_waitlist":{"type":"integer","examples":[0]},"group_booking_ttl_default":{"type":["string","null"],"examples":[null]},"max_group_demand_default":{"type":["string","null"],"examples":[null]},"max_group_size":{"type":["string","null"],"examples":[null]},"reserved_expiry":{"type":["string","null"],"examples":[null]},"post_feedback_form":{"type":["string","null"],"examples":[null]},"post_feedback_publish_at":{"type":["string","null"],"examples":[null]},"expression_of_interest":{"type":"integer","examples":[0]},"journey_complete_status":{"type":["string","null"],"examples":[null]},"journey_apply_status":{"type":["string","null"],"examples":[null]},"expression_of_interest_form":{"type":["string","null"],"examples":[null]},"cancel_expression_of_interest_form_id":{"type":["string","null"],"examples":[null]},"eoi_demand":{"type":"integer","examples":[0]},"sort_order":{"type":"integer","examples":[0]},"is_virtual":{"type":"integer","examples":[0]},"status":{"type":"string","examples":["published"]},"approval_status":{"type":"string","examples":["approved"]},"approval_reason":{"type":["string","null"],"examples":[null]},"promoted":{"type":"integer","examples":[0]},"public":{"type":"integer","examples":[0]},"is_cancelled":{"type":"integer","examples":[0]},"is_archived":{"type":"integer","examples":[0]},"public_shift":{"type":"integer","examples":[0]},"public_shift_default":{"type":"integer","examples":[0]},"token":{"type":"string","examples":["xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"]},"certificates_awarded":{"type":"integer","examples":[0]},"created_by":{"type":["string","null"],"examples":[null]},"updated_by":{"type":["string","null"],"examples":[null]},"deleted_at":{"type":["string","null"],"examples":[null]},"is_erased":{"type":"integer","examples":[0]},"created_at":{"type":"string","examples":["2026-06-09T05:36:43.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:43.000000Z"]},"deleted_by":{"type":["string","null"],"examples":[null]},"description":{"type":"string","examples":["<p>A weekend of community events across the city.</p>"]},"name":{"type":"string","examples":["Community Festival"]},"post_feedback":{"type":"string","examples":[""]},"tags":{"type":["string","null"],"examples":[null]},"address":{"type":"object","properties":{"iso":{"type":"string","examples":["AUS"]},"region_code":{"type":"string","examples":["VIC"]},"coordinates":{"type":"object","properties":{"latitude":{"type":"string","examples":["-37.814200"]},"longitude":{"type":"string","examples":["144.963200"]}}},"street_address_1":{"type":"string","examples":["1 Example Street"]},"street_address_2":{"type":["string","null"],"examples":[null]},"street_address_3":{"type":["string","null"],"examples":[null]},"city":{"type":"string","examples":["MELBOURNE"]},"postcode":{"type":"string","examples":["3000"]},"region":{"type":"string","examples":["VIC"]},"country":{"type":"string","examples":["AU"]},"latitude":{"type":"string","examples":["-37.814200"]},"longitude":{"type":"string","examples":["144.963200"]}}}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:example:20101:event:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"]},"address":{"type":"string","examples":["1 Example Street\nMELBOURNE\nVictoria\nAustralia\n3000"]},"address_oneline":{"type":"string","examples":["1 Example Street, MELBOURNE, Victoria, Australia, 3000"]},"address.country":{"type":"string","examples":["Australia"]},"address.country:raw":{"type":"string","examples":["AUS"]},"address.city":{"type":"string","examples":["MELBOURNE"]},"address.region":{"type":"string","examples":["Victoria"]},"address.region:raw":{"type":"string","examples":["VIC"]},"address.postcode":{"type":"string","examples":["3000"]},"address.street_address_1":{"type":"string","examples":["1 Example Street"]},"address.street_address_2":{"type":["string","null"],"examples":[null]},"address.street_address_3":{"type":["string","null"],"examples":[null]},"address.latitude":{"type":"string","examples":["-37.814200"]},"address.longitude":{"type":"string","examples":["144.963200"]},"allow_user_activities":{"type":"string","examples":["No"]},"approval_status":{"type":"string","examples":["Approved"]},"approval_status:value":{"type":"string","examples":["approved"]},"approval_status:array":{"type":"string","examples":["Approved"]},"apps_open_timestamp":{"type":"string","examples":["May 30, 2026, 5:00 AM"]},"apps_open_timestamp__date":{"type":"string","examples":["May 30, 2026"]},"apps_open_timestamp__time":{"type":"string","examples":["5:00 AM"]},"apps_open_timestamp__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"apps_open_timestamp__offset_minutes":{"type":"integer","examples":[0]},"apps_open_timestamp__dayofweek":{"type":"string","examples":["Saturday"]},"cancel_expression_of_interest_form_id":{"type":["string","null"],"examples":[null]},"cancel_expression_of_interest_form_id:value":{"type":["string","null"],"examples":[null]},"cancel_expression_of_interest_form_id:array":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["Jun 9, 2026, 5:36 AM"]},"created_at__date":{"type":"string","examples":["Jun 9, 2026"]},"created_at__time":{"type":"string","examples":["5:36 AM"]},"created_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"created_at__offset_minutes":{"type":"integer","examples":[0]},"created_at__dayofweek":{"type":"string","examples":["Tuesday"]},"end_timestamp":{"type":"string","examples":["Oct 1, 2026, 5:00 AM"]},"end_timestamp__date":{"type":"string","examples":["Oct 1, 2026"]},"end_timestamp__time":{"type":"string","examples":["5:00 AM"]},"end_timestamp__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"end_timestamp__offset_minutes":{"type":"integer","examples":[0]},"end_timestamp__dayofweek":{"type":"string","examples":["Thursday"]},"event_template_id":{"type":["string","null"],"examples":[null]},"event_template_id:value":{"type":["string","null"],"examples":[null]},"event_template_id:array":{"type":["string","null"],"examples":[null]},"event_type_id":{"type":"string","examples":["ratione laborum dolor"]},"event_type_id:value":{"type":"integer","examples":[11]},"event_type_id:array":{"type":"string","examples":["ratione laborum dolor"]},"expression_of_interest":{"type":"string","examples":["No"]},"headcount_location_venue_id":{"type":["string","null"],"examples":[null]},"headcount_location_venue_id:value":{"type":["string","null"],"examples":[null]},"headcount_location_venue_id:array":{"type":["string","null"],"examples":[null]},"is_ongoing":{"type":"string","examples":["No"]},"is_virtual":{"type":"string","examples":["No"]},"name":{"type":"string","examples":["Community Festival"]},"promoted":{"type":"string","examples":["No"]},"role_offer_address":{"type":"string","examples":["No"]},"self_checkin":{"type":"string","examples":["No"]},"shift_application_form_id_default":{"type":["string","null"],"examples":[null]},"shift_application_form_id_default:value":{"type":["string","null"],"examples":[null]},"shift_application_form_id_default:array":{"type":["string","null"],"examples":[null]},"shift_attended_form_id_default":{"type":["string","null"],"examples":[null]},"shift_attended_form_id_default:value":{"type":["string","null"],"examples":[null]},"shift_attended_form_id_default:array":{"type":["string","null"],"examples":[null]},"shift_checkin_form_id_default":{"type":["string","null"],"examples":[null]},"shift_checkin_form_id_default:value":{"type":["string","null"],"examples":[null]},"shift_checkin_form_id_default:array":{"type":["string","null"],"examples":[null]},"shift_checkout_form_id_default":{"type":["string","null"],"examples":[null]},"shift_checkout_form_id_default:value":{"type":["string","null"],"examples":[null]},"shift_checkout_form_id_default:array":{"type":["string","null"],"examples":[null]},"shift_feedback_form_id_default":{"type":["string","null"],"examples":[null]},"shift_feedback_form_id_default:value":{"type":["string","null"],"examples":[null]},"shift_feedback_form_id_default:array":{"type":["string","null"],"examples":[null]},"shift_precheckin_form_id_default":{"type":["string","null"],"examples":[null]},"shift_precheckin_form_id_default:value":{"type":["string","null"],"examples":[null]},"shift_precheckin_form_id_default:array":{"type":["string","null"],"examples":[null]},"shift_withdraw_form_id_default":{"type":["string","null"],"examples":[null]},"shift_withdraw_form_id_default:value":{"type":["string","null"],"examples":[null]},"shift_withdraw_form_id_default:array":{"type":["string","null"],"examples":[null]},"start_timestamp":{"type":"string","examples":["Sep 17, 2026, 5:00 AM"]},"start_timestamp__date":{"type":"string","examples":["Sep 17, 2026"]},"start_timestamp__time":{"type":"string","examples":["5:00 AM"]},"start_timestamp__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"start_timestamp__offset_minutes":{"type":"integer","examples":[0]},"start_timestamp__dayofweek":{"type":"string","examples":["Thursday"]},"status":{"type":"string","examples":["Published"]},"status:value":{"type":"string","examples":["published"]},"status:array":{"type":"string","examples":["Published"]},"tags":{"type":["string","null"],"examples":[null]},"tags:value":{"type":["string","null"],"examples":[null]},"tags:array":{"type":["string","null"],"examples":[null]},"updated_at":{"type":"string","examples":["Jun 9, 2026, 5:36 AM"]},"updated_at__date":{"type":"string","examples":["Jun 9, 2026"]},"updated_at__time":{"type":"string","examples":["5:36 AM"]},"updated_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"updated_at__offset_minutes":{"type":"integer","examples":[0]},"updated_at__dayofweek":{"type":"string","examples":["Tuesday"]},"visibility_hide_groups":{"type":"string","examples":[""]},"visibility_show_groups":{"type":"string","examples":[""]},"visibility_show_roleoffer":{"type":"string","examples":[""]},"full_name":{"type":"string","examples":["Community Festival"]},"event_type_name":{"type":"string","examples":["ratione laborum dolor"]},"grid_list_image":{"type":["string","null"],"examples":[null]},"is_eoi_demand_met":{"type":"boolean","examples":[false]},"has_payrun":{"type":"boolean","examples":[false]},"min_shifts":{"type":"integer","examples":[0]},"post_event_feedback_form_completed_at":{"type":["string","null"],"examples":[null]},"expression_of_interest_form_completed_at":{"type":["string","null"],"examples":[null]},"expression_of_interest_form_cancelled_at":{"type":["string","null"],"examples":[null]},"account_name":{"type":"string","examples":["Example Organisation"]}}},"relations":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]},"apply":{"type":"boolean","examples":[true]},"cancel":{"type":"boolean","examples":[true]},"can_publish":{"type":"boolean","examples":[true]}}},"attributes":{"type":"object","properties":{}}},"examples":[{"object":{"id":21476343,"parent_id":null,"event_template_id":null,"path":"21476343","account_id":20101,"event_type_id":11,"journey_id":null,"timezone":"UTC","start_timestamp":"2026-09-17T05:00:00.000000Z","end_timestamp":"2026-10-01T05:00:00.000000Z","is_ongoing":0,"apps_open_timestamp":"2026-05-30T05:00:00.000000Z","apps_close_timestamp":null,"headcount_location_venue_id":null,"headcount_functional_area_job_title_id":null,"shift_status_default":2,"max_shift_apps_per_user":0,"min_shift_apps_per_user":0,"min_shift_apps_per_shift_type":null,"max_shift_apps_per_shift_type":null,"gap_between_shifts":0,"shift_confirmed_status_default":3,"shift_rejected_status_default":6,"shift_can_withdraw_default":1,"shift_can_confirm_default":1,"shift_can_confirm_limit":0,"shift_can_withdraw_limit":0,"shift_checked_in_status_default":4,"shift_checked_out_status_default":4,"certificate_id":null,"shift_application_form_id_default":null,"shift_withdraw_form_id_default":null,"shift_checkin_form_id_default":null,"shift_attended_form_id_default":null,"shift_checkout_form_id_default":null,"shift_leader_feedback_form_id_default":null,"shift_feedback_form_id_default":null,"shift_precheckin_form_id_default":null,"shift_default_journey_complete_status":null,"shift_default_journey_id":null,"allow_user_activities":0,"user_activity_form_id":null,"training_ids":null,"banner_image":null,"grid_image":null,"minimum_dob":null,"minimum_age":null,"maximum_dob":null,"maximum_age":null,"visibility_show_groups":[],"visibility_hide_groups":[],"visibility_show_roleoffer":[],"role_offer_address":0,"checkin_visible_attributes":[],"shift_filter_attributes":null,"leader_shift_filter_attributes":null,"self_checkin":0,"self_checkin_open":1800,"self_checkin_close":1800,"self_checkout_close":1800,"checkin_close_default":0,"shift_precheckin_open_default":0,"shift_enable_waitlist_default":0,"geofence_checkin_limit_default":null,"max_waitlist":0,"group_booking_ttl_default":null,"max_group_demand_default":null,"max_group_size":null,"reserved_expiry":null,"post_feedback_form":null,"post_feedback_publish_at":null,"expression_of_interest":0,"journey_complete_status":null,"journey_apply_status":null,"expression_of_interest_form":null,"cancel_expression_of_interest_form_id":null,"eoi_demand":0,"sort_order":0,"is_virtual":0,"status":"published","approval_status":"approved","approval_reason":null,"promoted":0,"public":0,"is_cancelled":0,"is_archived":0,"public_shift":0,"public_shift_default":0,"token":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","certificates_awarded":0,"created_by":null,"updated_by":null,"deleted_at":null,"is_erased":0,"created_at":"2026-06-09T05:36:43.000000Z","updated_at":"2026-06-09T05:36:43.000000Z","deleted_by":null,"description":"<p>A weekend of community events across the city.</p>","name":"Community Festival","post_feedback":"","tags":null,"address":{"iso":"AUS","region_code":"VIC","coordinates":{"latitude":"-37.814200","longitude":"144.963200"},"street_address_1":"1 Example Street","street_address_2":null,"street_address_3":null,"city":"MELBOURNE","postcode":"3000","region":"VIC","country":"AU","latitude":"-37.814200","longitude":"144.963200"}},"nice":{"rrn":"rrn:example:20101:event:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","address":"1 Example Street\nMELBOURNE\nVictoria\nAustralia\n3000","address_oneline":"1 Example Street, MELBOURNE, Victoria, Australia, 3000","address.country":"Australia","address.country:raw":"AUS","address.city":"MELBOURNE","address.region":"Victoria","address.region:raw":"VIC","address.postcode":"3000","address.street_address_1":"1 Example Street","address.street_address_2":null,"address.street_address_3":null,"address.latitude":"-37.814200","address.longitude":"144.963200","allow_user_activities":"No","approval_status":"Approved","approval_status:value":"approved","approval_status:array":"Approved","apps_open_timestamp":"May 30, 2026, 5:00 AM","apps_open_timestamp__date":"May 30, 2026","apps_open_timestamp__time":"5:00 AM","apps_open_timestamp__offset":" (+00:00 UTC)","apps_open_timestamp__offset_minutes":0,"apps_open_timestamp__dayofweek":"Saturday","cancel_expression_of_interest_form_id":null,"cancel_expression_of_interest_form_id:value":null,"cancel_expression_of_interest_form_id:array":null,"created_at":"Jun 9, 2026, 5:36 AM","created_at__date":"Jun 9, 2026","created_at__time":"5:36 AM","created_at__offset":" (+00:00 UTC)","created_at__offset_minutes":0,"created_at__dayofweek":"Tuesday","end_timestamp":"Oct 1, 2026, 5:00 AM","end_timestamp__date":"Oct 1, 2026","end_timestamp__time":"5:00 AM","end_timestamp__offset":" (+00:00 UTC)","end_timestamp__offset_minutes":0,"end_timestamp__dayofweek":"Thursday","event_template_id":null,"event_template_id:value":null,"event_template_id:array":null,"event_type_id":"ratione laborum dolor","event_type_id:value":11,"event_type_id:array":"ratione laborum dolor","expression_of_interest":"No","headcount_location_venue_id":null,"headcount_location_venue_id:value":null,"headcount_location_venue_id:array":null,"is_ongoing":"No","is_virtual":"No","name":"Community Festival","promoted":"No","role_offer_address":"No","self_checkin":"No","shift_application_form_id_default":null,"shift_application_form_id_default:value":null,"shift_application_form_id_default:array":null,"shift_attended_form_id_default":null,"shift_attended_form_id_default:value":null,"shift_attended_form_id_default:array":null,"shift_checkin_form_id_default":null,"shift_checkin_form_id_default:value":null,"shift_checkin_form_id_default:array":null,"shift_checkout_form_id_default":null,"shift_checkout_form_id_default:value":null,"shift_checkout_form_id_default:array":null,"shift_feedback_form_id_default":null,"shift_feedback_form_id_default:value":null,"shift_feedback_form_id_default:array":null,"shift_precheckin_form_id_default":null,"shift_precheckin_form_id_default:value":null,"shift_precheckin_form_id_default:array":null,"shift_withdraw_form_id_default":null,"shift_withdraw_form_id_default:value":null,"shift_withdraw_form_id_default:array":null,"start_timestamp":"Sep 17, 2026, 5:00 AM","start_timestamp__date":"Sep 17, 2026","start_timestamp__time":"5:00 AM","start_timestamp__offset":" (+00:00 UTC)","start_timestamp__offset_minutes":0,"start_timestamp__dayofweek":"Thursday","status":"Published","status:value":"published","status:array":"Published","tags":null,"tags:value":null,"tags:array":null,"updated_at":"Jun 9, 2026, 5:36 AM","updated_at__date":"Jun 9, 2026","updated_at__time":"5:36 AM","updated_at__offset":" (+00:00 UTC)","updated_at__offset_minutes":0,"updated_at__dayofweek":"Tuesday","visibility_hide_groups":"","visibility_show_groups":"","visibility_show_roleoffer":"","full_name":"Community Festival","event_type_name":"ratione laborum dolor","grid_list_image":null,"is_eoi_demand_met":false,"has_payrun":false,"min_shifts":0,"post_event_feedback_form_completed_at":null,"expression_of_interest_form_completed_at":null,"expression_of_interest_form_cancelled_at":null,"account_name":"Example Organisation"},"relations":[],"permissions":{"read":true,"update":true,"delete":true,"apply":true,"cancel":true,"can_publish":true},"attributes":{}}]},"id":"schema_406"},"schema_407":{"kind":"json-schema","data":{"type":"integer","examples":[21476343]},"id":"schema_407"},"schema_408":{"kind":"json-schema","data":{"type":"object","properties":{"event_template_id":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The template to build the event from. Its values are applied over whatever else you send. Send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_template"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to start from nothing instead. Where the account has templates configured, one of the two is expected."},"children":[]}]}]}],"examples":[1]},"name":{"type":"string","description":"What the event is called. Shown to everyone who can see the event.","examples":["Community Festival"]},"event_type_id":{"type":"integer","description":"Which of the account's event types this is. Defaults to the account's first type when left out.","examples":[11]},"description":{"type":"string","description":"The event's description, as HTML. Shown on the event's page in the portal.","examples":["<p>A weekend of community events across the city.</p>"]},"timezone":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The timezone every timestamp on the event is given in, as an IANA name such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Australia/Melbourne"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Defaults to the account's timezone."},"children":[]}]}]}],"examples":["UTC"]},"start_timestamp":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the event starts, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD HH:MM:SS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the event's timezone. Required when the event is not ongoing. Cleared if you mark the event ongoing."},"children":[]}]}]}],"examples":["2026-09-17T05:00:00.000000Z"]},"end_timestamp":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the event ends, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD HH:MM:SS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the event's timezone. Defaults to the start when the event is not ongoing. Cleared if you mark the event ongoing."},"children":[]}]}]}],"examples":["2026-10-01T05:00:00.000000Z"]},"is_virtual":{"type":"boolean","description":"Whether the event has no physical location. A virtual event needs neither an address nor a venue.","examples":[0]},"shift_status_default":{"type":"integer","description":"The status a new application to a shift on this event starts in. Defaults to the account's.","examples":[2]},"shift_confirmed_status_default":{"type":"integer","description":"The status applied when someone confirms their place on a shift. Defaults to the account's.","examples":[3]},"shift_rejected_status_default":{"type":"integer","description":"The status applied when someone is turned down for a shift. Defaults to the account's.","examples":[6]},"shift_can_withdraw_default":{"type":"boolean","description":"Whether people may withdraw from this event's shifts.","examples":[1]},"shift_can_confirm_default":{"type":"boolean","description":"Whether people are asked to confirm their place on this event's shifts.","examples":[1]},"shift_can_withdraw_limit":{"type":"integer","description":"How long before a shift starts withdrawing stops being allowed, in seconds.","examples":[0]},"shift_can_confirm_limit":{"type":"integer","description":"How long before a shift starts confirming stops being allowed, in seconds.","examples":[0]},"shift_checked_in_status_default":{"type":"integer","description":"The status applied when someone checks in to a shift. Defaults to the account's.","examples":[4]},"shift_checked_out_status_default":{"type":"integer","description":"The status applied when someone checks out of a shift. Defaults to the account's.","examples":[4]},"apps_open_timestamp":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When applications open, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD HH:MM:SS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the event's timezone. Leave empty for applications that are open from the start."},"children":[]}]}]}],"examples":["2026-05-30T05:00:00.000000Z"]},"apps_close_timestamp":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When applications close, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD HH:MM:SS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the event's timezone. Must be after "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"apps_open_timestamp"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"max_shift_apps_per_user":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The most shifts on this event one person may hold. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" means no limit."},"children":[]}]}]}],"examples":[0]},"min_shift_apps_per_user":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The fewest shifts on this event one person is expected to hold. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" means no minimum."},"children":[]}]}]}],"examples":[0]},"min_shift_apps_per_shift_type":{"type":"object","description":"Per-shift-type minimums, as an object keyed by shift type id.","properties":{},"examples":["{}"]},"max_shift_apps_per_shift_type":{"type":"object","description":"Per-shift-type ceilings, as an object keyed by shift type id.","properties":{},"examples":["{}"]},"gap_between_shifts":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The rest required between two shifts on this event, in seconds. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" means none."},"children":[]}]}]}],"examples":[0]},"role_offer_address":{"type":"boolean","description":"Whether the event takes its location from the role offer people applied through rather than from its own address.","examples":[0]},"status":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether the event is visible to people who can apply: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"published"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"unpublished"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"auto_publish"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"submit_for_approval"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rejected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". New events start unpublished."},"children":[]}]}]}],"examples":["published"]},"parent_id":{"type":"integer","description":"The id of the event this one sits beneath, for accounts that group events into a parent and its sub-events.","examples":[1]},"address":{"type":"object","description":"Where the event takes place. Required unless the event is virtual or is held at a venue.","properties":{},"examples":[{"iso":"AUS","region_code":"VIC","coordinates":{"latitude":"-37.814200","longitude":"144.963200"},"street_address_1":"1 Example Street","street_address_2":null,"street_address_3":null,"city":"MELBOURNE","postcode":"3000","region":"VIC","country":"AU","latitude":"-37.814200","longitude":"144.963200"}]},"headcount_location_venue_id":{"type":"integer","description":"The venue the event is held at, instead of an address of its own.","examples":[1]},"headcount_functional_area_job_title_id":{"type":"integer","description":"The job title this event's work is counted against for workforce planning.","examples":[1]},"certificate_id":{"type":"integer","description":"The certificate awarded for taking part in this event.","examples":[1]},"visibility_show_groups":{"type":"array","description":"Restrict the event to these groups, as a list of group ids. An empty list shows it to everyone.","items":{"type":"integer"},"examples":[[]]},"visibility_hide_groups":{"type":"array","description":"Hide the event from these groups, as a list of group ids.","items":{"type":"integer"},"examples":[[]]},"visibility_show_roleoffer":{"type":"array","description":"Restrict the event to people who came through these role offers, as a list of role offer ids.","items":{"type":"integer"},"examples":[[]]},"shift_application_form_id_default":{"type":"integer","description":"The form filled in when applying for one of this event's shifts.","examples":[1]},"shift_precheckin_form_id_default":{"type":"integer","description":"The form filled in before checking in to one of this event's shifts.","examples":[1]},"shift_checkin_form_id_default":{"type":"integer","description":"The form filled in at check-in.","examples":[1]},"shift_attended_form_id_default":{"type":"integer","description":"The form filled in once attendance is recorded.","examples":[1]},"shift_checkout_form_id_default":{"type":"integer","description":"The form filled in at check-out.","examples":[1]},"shift_feedback_form_id_default":{"type":"integer","description":"The feedback form offered after one of this event's shifts.","examples":[1]},"shift_leader_feedback_form_id_default":{"type":"integer","description":"The feedback form a shift leader is asked to fill in.","examples":[1]},"shift_precheckin_open_default":{"type":"integer","description":"How long before a shift starts its pre-check-in form becomes available, in seconds.","examples":[0]},"max_group_demand_default":{"type":"integer","description":"The most places a group leader may reserve on one of this event's shifts.","examples":[1]},"group_booking_ttl_default":{"type":"integer","description":"How long a group leader's reserved places are held before they are released, in seconds.","examples":[1]},"geofence_checkin_limit_default":{"type":"integer","description":"How close to the shift's location someone must be to check in, in metres. Empty means no limit.","examples":[1]},"self_checkin":{"type":"boolean","description":"Whether people may check themselves in to this event's shifts.","examples":[0]},"self_checkin_open":{"type":"integer","description":"How long before a shift starts self check-in opens, in seconds.","examples":[1800]},"self_checkin_close":{"type":"integer","description":"How long after a shift starts self check-in closes, in seconds.","examples":[1800]},"self_checkout_close":{"type":"integer","description":"How long after a shift ends self check-out closes, in seconds.","examples":[1800]},"checkin_close_default":{"type":"integer","description":"How long after a shift ends check-in closes, in seconds.","examples":[0]},"checkin_visible_attributes":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Which fields are shown on the check-in page, as a list of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"<entity>.<attribute>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" names such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user.first_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"items":{"type":"string"},"examples":[[]]},"shift_filter_attributes":{"type":"array","description":"Which attributes people may filter this event's shifts by, as a list of attribute ids.","items":{"type":"integer"},"examples":[[]]},"leader_shift_filter_attributes":{"type":"array","description":"Which attributes a shift leader may filter by, as a list of attribute ids.","items":{"type":"integer"},"examples":[[]]},"post_feedback":{"type":"string","description":"The message shown once the post-event feedback form is available, as HTML.","examples":[""]},"post_feedback_publish_at":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the post-event feedback form becomes available, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD HH:MM:SS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"training_ids":{"type":"array","description":"The training people must have completed before they can apply, as a list of training ids.","items":{"type":"integer"},"examples":[[]]},"banner_image":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The event's banner image. Send the URL of an image already uploaded through Rosterfy, or the image itself as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"multipart/form-data"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A URL on any other host is rejected."},"children":[]}]}]}],"examples":[null]},"grid_image":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The image shown for the event in listings. Same accepted values as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"banner_image"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"mobile_banner_image":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The banner image used on smaller screens. Same accepted values as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"banner_image"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"minimum_dob":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The latest date of birth allowed, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Cannot be combined with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"minimum_age"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"minimum_age":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The youngest age allowed, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"years:months"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"16:0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Cannot be combined with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"minimum_dob"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"maximum_dob":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The earliest date of birth allowed, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Cannot be combined with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"maximum_age"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"maximum_age":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The oldest age allowed, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"years:months"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Cannot be combined with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"maximum_dob"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"public":{"type":"boolean","description":"Whether the event is visible to people who are not signed in, on accounts that allow public browsing.","examples":[0]},"public_shift":{"type":"boolean","description":"Whether this event's shifts are visible to people who are not signed in.","examples":[0]},"public_shift_default":{"type":"boolean","description":"Whether a newly created shift on this event is public by default.","examples":[0]},"token":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The event's public reference, the last part of its "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rrn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Generated when the event is created; there is rarely a reason to set your own."},"children":[]}]}]}],"examples":["xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"]},"expression_of_interest":{"type":"boolean","description":"Whether people may register interest in the event without applying for a specific shift.","examples":[0]},"expression_of_interest_form":{"type":"integer","description":"The form filled in when registering interest.","examples":[1]},"shift_enable_waitlist_default":{"type":"boolean","description":"Whether a full shift on this event takes a waitlist.","examples":[0]},"max_waitlist":{"type":"integer","description":"How many people a shift's waitlist holds.","examples":[0]},"allow_user_activities":{"type":"boolean","description":"Whether people may log their own activity against this event.","examples":[0]},"user_activity_form_id":{"type":"integer","description":"The form used to log that activity.","examples":[1]},"approval_status":{"type":"string","description":"Where the event sits in the account's approval process, when the account requires events to be approved.","examples":["approved"]},"approval_reason":{"type":"string","description":"Free text explaining the approval decision.","examples":[null]},"is_ongoing":{"type":"boolean","description":"Whether the event runs indefinitely rather than between two dates. Setting it clears the start and end.","examples":[0]},"sort_order":{"type":"integer","description":"Where the event sits when events are ordered manually. Lower comes first.","examples":[0]},"post_feedback_form":{"type":"integer","description":"The feedback form offered after the event itself.","examples":[1]},"is_archived":{"type":"boolean","description":"Whether the event is archived. Archived events stay readable but are kept out of the day-to-day listings.","examples":[0]},"custom_*":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A custom attribute, named by its code - custom_shirt_size, for example. The value follows the attribute's own type, so it may be a string, a number, a boolean or a list. See the custom attributes documentation."},"children":[]}]}]}],"examples":[null]}}},"id":"schema_408"},"schema_409":{"kind":"json-schema","data":{"type":"integer","examples":[21476336]},"id":"schema_409"},"schema_410":{"kind":"json-schema","data":{"type":"integer","examples":[20539680]},"id":"schema_410"},"schema_411":{"kind":"json-schema","data":{"type":"string","description":"Match people by name, email, phone or reference, the way\nthe console's search box does.","examples":["smith"]},"id":"schema_411"},"schema_412":{"kind":"json-schema","data":{"type":"boolean","description":"Keep only assignments at a status that counts towards\nthe shift's demand.","examples":[true]},"id":"schema_412"},"schema_413":{"kind":"json-schema","data":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Keep only assignments at an active status. On"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/event/shift/user"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", where no shift is named, this also narrows the results to"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"shifts starting within twelve hours either side of now, and a caller who cannot"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"update shift assignments sees only the shifts they lead."},"children":[]}]}]}],"examples":[true]},"id":"schema_413"},"schema_414":{"kind":"json-schema","data":{"type":"array","description":"A list of extras to include in the response. These are objects or arrays that are not part of\nthe model's primary attributes, such as stats and counts.\nFor fast responses, avoid requesting them if you don't need them. ","items":{"type":"string","enum":["shift_schedule_view_attributes","payrun","stats","other_shift_user_details","referred_from"]},"examples":[["shift_schedule_view_attributes"]]},"id":"schema_414"},"schema_415":{"kind":"json-schema","data":{"type":"array","description":"A list of relations to include in the response. May be single records or collections.\nIt is often more efficient to retrieve this way, to avoid follow-up API calls.","items":{"type":"string","enum":["role_offer","integration_data","hasManyDeepFromRelationsWithConstraints","hasOneDeepFromRelationsWithConstraints","hasManyDeepFromReverse","hasOneDeepFromReverse"]},"examples":[["role_offer"]]},"id":"schema_415"},"schema_416":{"kind":"json-schema","data":{"type":"array","items":{"type":"object","properties":{"current_page":{"type":"integer","examples":[1]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[3001]},"event_shift_id":{"type":"integer","examples":[2001]},"user_id":{"type":"integer","examples":[1234]},"post_shift_feedback_form_completed_at":{"type":["string","null"],"examples":[null]},"precheckin_form_completed_at":{"type":["string","null"],"examples":[null]},"event_shift_status_id":{"type":"integer","examples":[3]},"demand":{"type":"integer","examples":[1]},"break":{"type":["string","null"],"examples":[null]},"start_timestamp":{"type":["string","null"],"examples":[null]},"end_timestamp":{"type":["string","null"],"examples":[null]},"cost":{"type":"string","examples":["0.00"]},"cost_meta":{"type":"array","examples":[[]]},"meta":{"type":["string","null"],"examples":[null]},"latitude":{"type":["string","null"],"examples":[null]},"longitude":{"type":["string","null"],"examples":[null]},"payment_authorization_id":{"type":["string","null"],"examples":[null]},"waitlist_notification_last_sent_at":{"type":["string","null"],"examples":[null]},"timesheet_status":{"type":"string","examples":["pending"]},"rating":{"type":["string","null"],"examples":[null]},"demand_expire":{"type":["string","null"],"examples":[null]},"deleted_at":{"type":["string","null"],"examples":[null]},"is_erased":{"type":"integer","examples":[0]},"created_at":{"type":"string","examples":["2026-06-09T05:36:42.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:42.000000Z"]},"deleted_by":{"type":["string","null"],"examples":[null]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20000:event_shift_user:3001"]},"journey_step":{"type":"string","examples":[""]},"journey_step_category":{"type":"string","examples":[""]},"created_at":{"type":"string","examples":["Jun 9, 2026, 5:36 AM"]},"created_at__date":{"type":"string","examples":["Jun 9, 2026"]},"created_at__time":{"type":"string","examples":["5:36 AM"]},"created_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"created_at__offset_minutes":{"type":"integer","examples":[0]},"created_at__dayofweek":{"type":"string","examples":["Tuesday"]},"event_shift_status_id":{"type":"string","examples":["Confirmed"]},"event_shift_status_id:value":{"type":"integer","examples":[3]},"event_shift_status_id:array":{"type":"string","examples":["Confirmed"]},"payment_authorization_id":{"type":"string","examples":[""]},"timesheet_status":{"type":"string","examples":["Pending"]},"timesheet_status:value":{"type":"string","examples":["pending"]},"timesheet_status:array":{"type":"string","examples":["Pending"]},"updated_at":{"type":"string","examples":["Jun 9, 2026, 5:36 AM"]},"updated_at__date":{"type":"string","examples":["Jun 9, 2026"]},"updated_at__time":{"type":"string","examples":["5:36 AM"]},"updated_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"updated_at__offset_minutes":{"type":"integer","examples":[0]},"updated_at__dayofweek":{"type":"string","examples":["Tuesday"]},"attended":{"type":"object","properties":{"seconds":{"type":"integer","examples":[0]},"minutes":{"type":"integer","examples":[0]},"hours":{"type":"integer","examples":[0]},"pretty":{"type":"string","examples":["00:00:00"]}}},"attended_without_checkout":{"type":"object","properties":{"seconds":{"type":"integer","examples":[0]},"minutes":{"type":"integer","examples":[0]},"hours":{"type":"integer","examples":[0]},"pretty":{"type":"string","examples":["00:00:00"]}}},"event_id":{"type":"integer","examples":[1001]},"event_name":{"type":"string","examples":["Example Event"]},"is_event_leader":{"type":"boolean","examples":[false]},"is_leader":{"type":"boolean","examples":[false]},"checkin_location":{"type":"array","examples":[[]]},"shift_name":{"type":"string","examples":["Example Shift"]},"user_name":{"type":"string","examples":["Example Volunteer"]},"requires_pre_checkin":{"type":"boolean","examples":[false]},"has_shift_attended_form":{"type":"boolean","examples":[false]},"has_checkin_form":{"type":"boolean","examples":[false]},"has_checkout_form":{"type":"boolean","examples":[false]},"shift_checkin_visible_attributes":{"type":"array","examples":[[]]},"has_confirmed":{"type":"boolean","examples":[true]},"has_rejected":{"type":"boolean","examples":[false]},"has_cancelled":{"type":"boolean","examples":[false]}}},"relations":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]},"status_update":{"type":"boolean","examples":[true]},"precheckin":{"type":"boolean","examples":[false]},"checkin":{"type":"boolean","examples":[true]},"checkout":{"type":"boolean","examples":[true]},"submitAttendedForm":{"type":"boolean","examples":[false]}}},"attributes":{"type":"array","examples":[[]]},"is_leader":{"type":"integer","examples":[0]}}},"examples":[[{"object":{"id":3001,"event_shift_id":2001,"user_id":1234,"post_shift_feedback_form_completed_at":null,"precheckin_form_completed_at":null,"event_shift_status_id":3,"demand":1,"break":null,"start_timestamp":null,"end_timestamp":null,"cost":"0.00","cost_meta":[],"meta":null,"latitude":null,"longitude":null,"payment_authorization_id":null,"waitlist_notification_last_sent_at":null,"timesheet_status":"pending","rating":null,"demand_expire":null,"deleted_at":null,"is_erased":0,"created_at":"2026-06-09T05:36:42.000000Z","updated_at":"2026-06-09T05:36:42.000000Z","deleted_by":null},"nice":{"rrn":"rrn:local:20000:event_shift_user:3001","journey_step":"","journey_step_category":"","created_at":"Jun 9, 2026, 5:36 AM","created_at__date":"Jun 9, 2026","created_at__time":"5:36 AM","created_at__offset":" (+00:00 UTC)","created_at__offset_minutes":0,"created_at__dayofweek":"Tuesday","event_shift_status_id":"Confirmed","event_shift_status_id:value":3,"event_shift_status_id:array":"Confirmed","payment_authorization_id":"","timesheet_status":"Pending","timesheet_status:value":"pending","timesheet_status:array":"Pending","updated_at":"Jun 9, 2026, 5:36 AM","updated_at__date":"Jun 9, 2026","updated_at__time":"5:36 AM","updated_at__offset":" (+00:00 UTC)","updated_at__offset_minutes":0,"updated_at__dayofweek":"Tuesday","attended":{"seconds":0,"minutes":0,"hours":0,"pretty":"00:00:00"},"attended_without_checkout":{"seconds":0,"minutes":0,"hours":0,"pretty":"00:00:00"},"event_id":1001,"event_name":"Example Event","is_event_leader":false,"is_leader":false,"checkin_location":[],"shift_name":"Example Shift","user_name":"Example Volunteer","requires_pre_checkin":false,"has_shift_attended_form":false,"has_checkin_form":false,"has_checkout_form":false,"shift_checkin_visible_attributes":[],"has_confirmed":true,"has_rejected":false,"has_cancelled":false},"relations":[],"permissions":{"read":true,"update":true,"delete":true,"status_update":true,"precheckin":false,"checkin":true,"checkout":true,"submitAttendedForm":false},"attributes":[],"is_leader":0},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}]]},"first_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/event/{event}/shift/{shift}/user?per_page=5&_locale=en-US&page=1"]},"from":{"type":"integer","examples":[1]},"next_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/event/{event}/shift/{shift}/user?per_page=5&_locale=en-US&page=2"]},"path":{"type":"string","examples":["https://example.rosterfy.com/api/v2/event/{event}/shift/{shift}/user"]},"per_page":{"type":"integer","examples":[5]},"prev_page_url":{"type":["string","null"],"examples":[null]},"to":{"type":"integer","examples":[5]}}},"examples":[[{"current_page":1,"data":[{"object":{"id":3001,"event_shift_id":2001,"user_id":1234,"post_shift_feedback_form_completed_at":null,"precheckin_form_completed_at":null,"event_shift_status_id":3,"demand":1,"break":null,"start_timestamp":null,"end_timestamp":null,"cost":"0.00","cost_meta":[],"meta":null,"latitude":null,"longitude":null,"payment_authorization_id":null,"waitlist_notification_last_sent_at":null,"timesheet_status":"pending","rating":null,"demand_expire":null,"deleted_at":null,"is_erased":0,"created_at":"2026-06-09T05:36:42.000000Z","updated_at":"2026-06-09T05:36:42.000000Z","deleted_by":null},"nice":{"rrn":"rrn:local:20000:event_shift_user:3001","journey_step":"","journey_step_category":"","created_at":"Jun 9, 2026, 5:36 AM","created_at__date":"Jun 9, 2026","created_at__time":"5:36 AM","created_at__offset":" (+00:00 UTC)","created_at__offset_minutes":0,"created_at__dayofweek":"Tuesday","event_shift_status_id":"Confirmed","event_shift_status_id:value":3,"event_shift_status_id:array":"Confirmed","payment_authorization_id":"","timesheet_status":"Pending","timesheet_status:value":"pending","timesheet_status:array":"Pending","updated_at":"Jun 9, 2026, 5:36 AM","updated_at__date":"Jun 9, 2026","updated_at__time":"5:36 AM","updated_at__offset":" (+00:00 UTC)","updated_at__offset_minutes":0,"updated_at__dayofweek":"Tuesday","attended":{"seconds":0,"minutes":0,"hours":0,"pretty":"00:00:00"},"attended_without_checkout":{"seconds":0,"minutes":0,"hours":0,"pretty":"00:00:00"},"event_id":1001,"event_name":"Example Event","is_event_leader":false,"is_leader":false,"checkin_location":[],"shift_name":"Example Shift","user_name":"Example Volunteer","requires_pre_checkin":false,"has_shift_attended_form":false,"has_checkin_form":false,"has_checkout_form":false,"shift_checkin_visible_attributes":[],"has_confirmed":true,"has_rejected":false,"has_cancelled":false},"relations":[],"permissions":{"read":true,"update":true,"delete":true,"status_update":true,"precheckin":false,"checkin":true,"checkout":true,"submitAttendedForm":false},"attributes":[],"is_leader":0},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}],"first_page_url":"https://example.rosterfy.com/api/v2/event/{event}/shift/{shift}/user?per_page=5&_locale=en-US&page=1","from":1,"next_page_url":"https://example.rosterfy.com/api/v2/event/{event}/shift/{shift}/user?per_page=5&_locale=en-US&page=2","path":"https://example.rosterfy.com/api/v2/event/{event}/shift/{shift}/user","per_page":5,"prev_page_url":null,"to":5}]]},"id":"schema_416"},"schema_417":{"kind":"json-schema","data":{"type":"object","properties":{"event_shift_status_id":{"type":"integer","description":"The status the assignment starts at, or moves to. Must be one of the account's own shift statuses; a status the account treats as cancelled is refused.","examples":[3001]},"user_id":{"type":"integer","description":"The ID of the person to put on the shift.","examples":[1234]},"is_leader":{"type":"boolean","description":"Whether this person leads the shift. Setting it on a shift that already has as many leaders as it allows returns a 405 - see the description.","examples":[true]},"start_timestamp":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the person checked in, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DDTHH:MM"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Clearing it while an end time is still set is refused."},"children":[]}]}]}],"examples":[null]},"end_timestamp":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the person checked out, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DDTHH:MM"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"break":{"type":"number","description":"Unpaid break taken during the shift, in minutes. Subtracted from the attended time.","examples":[1.23]},"repeat":{"type":"boolean","description":"Apply the same change to this person's assignments on every later shift linked to this one. Only meaningful on a shift that belongs to a linked series.","examples":[true]},"timesheet_status":{"type":"string","description":"Where the assignment sits in timesheet approval.","examples":["pending"]},"family_member_ids":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"IDs of family members of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to put on the shift alongside them. Only members of that person's own family are used; anything else is ignored."},"children":[]}]}]}],"items":{"type":"integer"},"examples":[[]]},"swap_from_shift_id":{"type":"integer","description":"Move the person off this shift as part of the same request - see the description.","examples":[1]},"custom_*":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A custom attribute, named by its code - custom_shirt_size, for example. The value follows the attribute's own type, so it may be a string, a number, a boolean or a list. See the custom attributes documentation."},"children":[]}]}]}],"examples":[null]}},"required":["event_shift_status_id","user_id"]},"id":"schema_417"},"schema_418":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"timesheet_status":{"type":"string","examples":["pending"]},"event_shift_status_id":{"type":"integer","examples":[3001]},"user_id":{"type":"integer","examples":[1234]},"event_shift_id":{"type":"integer","examples":[2001]},"cost_meta":{"type":"array","examples":[[]]},"updated_at":{"type":"string","examples":["2026-08-12T00:40:25.000000Z"]},"created_at":{"type":"string","examples":["2026-08-12T00:40:25.000000Z"]},"id":{"type":"integer","examples":[3001]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20000:event_shift_user:3001"]},"journey_step":{"type":"string","examples":[""]},"journey_step_category":{"type":"string","examples":[""]},"created_at":{"type":"string","examples":["Aug 12, 2026, 12:40 AM"]},"created_at__date":{"type":"string","examples":["Aug 12, 2026"]},"created_at__time":{"type":"string","examples":["12:40 AM"]},"created_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"created_at__offset_minutes":{"type":"integer","examples":[0]},"created_at__dayofweek":{"type":"string","examples":["Wednesday"]},"event_shift_status_id":{"type":"string","examples":["Pending"]},"event_shift_status_id:value":{"type":"integer","examples":[2]},"event_shift_status_id:array":{"type":"string","examples":["Pending"]},"payment_authorization_id":{"type":"string","examples":[""]},"timesheet_status":{"type":"string","examples":["Pending"]},"timesheet_status:value":{"type":"string","examples":["pending"]},"timesheet_status:array":{"type":"string","examples":["Pending"]},"updated_at":{"type":"string","examples":["Aug 12, 2026, 12:40 AM"]},"updated_at__date":{"type":"string","examples":["Aug 12, 2026"]},"updated_at__time":{"type":"string","examples":["12:40 AM"]},"updated_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"updated_at__offset_minutes":{"type":"integer","examples":[0]},"updated_at__dayofweek":{"type":"string","examples":["Wednesday"]},"attended":{"type":"object","properties":{"seconds":{"type":"integer","examples":[0]},"minutes":{"type":"integer","examples":[0]},"hours":{"type":"integer","examples":[0]},"pretty":{"type":"string","examples":["00:00:00"]}}},"attended_without_checkout":{"type":"object","properties":{"seconds":{"type":"integer","examples":[0]},"minutes":{"type":"integer","examples":[0]},"hours":{"type":"integer","examples":[0]},"pretty":{"type":"string","examples":["00:00:00"]}}},"event_id":{"type":"integer","examples":[1001]},"event_name":{"type":"string","examples":["Example Event"]},"is_event_leader":{"type":"boolean","examples":[false]},"is_leader":{"type":"boolean","examples":[false]},"checkin_location":{"type":"array","examples":[[]]},"shift_name":{"type":"string","examples":["Example Shift"]},"user_name":{"type":"string","examples":["Example Volunteer"]},"requires_pre_checkin":{"type":"boolean","examples":[false]},"has_shift_attended_form":{"type":"boolean","examples":[false]},"has_checkin_form":{"type":"boolean","examples":[false]},"has_checkout_form":{"type":"boolean","examples":[false]},"shift_checkin_visible_attributes":{"type":"array","examples":[[]]},"has_confirmed":{"type":"boolean","examples":[false]},"has_rejected":{"type":"boolean","examples":[false]},"has_cancelled":{"type":"boolean","examples":[false]}}},"relations":{"type":"object","properties":{}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]},"status_update":{"type":"boolean","examples":[true]},"precheckin":{"type":"boolean","examples":[false]},"checkin":{"type":"boolean","examples":[true]},"checkout":{"type":"boolean","examples":[true]},"submitAttendedForm":{"type":"boolean","examples":[false]}}},"attributes":{"type":"object","properties":{}},"is_leader":{"type":"integer","examples":[0]}},"examples":[{"object":{"timesheet_status":"pending","event_shift_status_id":3001,"user_id":1234,"event_shift_id":2001,"cost_meta":[],"updated_at":"2026-08-12T00:40:25.000000Z","created_at":"2026-08-12T00:40:25.000000Z","id":3001},"nice":{"rrn":"rrn:local:20000:event_shift_user:3001","journey_step":"","journey_step_category":"","created_at":"Aug 12, 2026, 12:40 AM","created_at__date":"Aug 12, 2026","created_at__time":"12:40 AM","created_at__offset":" (+00:00 UTC)","created_at__offset_minutes":0,"created_at__dayofweek":"Wednesday","event_shift_status_id":"Pending","event_shift_status_id:value":2,"event_shift_status_id:array":"Pending","payment_authorization_id":"","timesheet_status":"Pending","timesheet_status:value":"pending","timesheet_status:array":"Pending","updated_at":"Aug 12, 2026, 12:40 AM","updated_at__date":"Aug 12, 2026","updated_at__time":"12:40 AM","updated_at__offset":" (+00:00 UTC)","updated_at__offset_minutes":0,"updated_at__dayofweek":"Wednesday","attended":{"seconds":0,"minutes":0,"hours":0,"pretty":"00:00:00"},"attended_without_checkout":{"seconds":0,"minutes":0,"hours":0,"pretty":"00:00:00"},"event_id":1001,"event_name":"Example Event","is_event_leader":false,"is_leader":false,"checkin_location":[],"shift_name":"Example Shift","user_name":"Example Volunteer","requires_pre_checkin":false,"has_shift_attended_form":false,"has_checkin_form":false,"has_checkout_form":false,"shift_checkin_visible_attributes":[],"has_confirmed":false,"has_rejected":false,"has_cancelled":false},"relations":{},"permissions":{"read":true,"update":true,"delete":true,"status_update":true,"precheckin":false,"checkin":true,"checkout":true,"submitAttendedForm":false},"attributes":{},"is_leader":0}]},"id":"schema_418"},"schema_419":{"kind":"json-schema","data":{"type":"integer","examples":[1001]},"id":"schema_419"},"schema_420":{"kind":"json-schema","data":{"type":"integer","examples":[2001]},"id":"schema_420"},"schema_421":{"kind":"json-schema","data":{"type":"integer","examples":[3001]},"id":"schema_421"},"schema_422":{"kind":"json-schema","data":{"type":"boolean","description":"Return the reduced view a shift leader is shown,\ncarrying only the check-in and check-out fields rather than the whole assignment.","examples":[true]},"id":"schema_422"},"schema_423":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[3001]},"event_shift_id":{"type":"integer","examples":[2001]},"user_id":{"type":"integer","examples":[1234]},"post_shift_feedback_form_completed_at":{"type":["string","null"],"examples":[null]},"precheckin_form_completed_at":{"type":["string","null"],"examples":[null]},"event_shift_status_id":{"type":"integer","examples":[3]},"demand":{"type":"integer","examples":[1]},"break":{"type":["string","null"],"examples":[null]},"start_timestamp":{"type":["string","null"],"examples":[null]},"end_timestamp":{"type":["string","null"],"examples":[null]},"cost":{"type":"string","examples":["0.00"]},"cost_meta":{"type":"array","examples":[[]]},"meta":{"type":["string","null"],"examples":[null]},"latitude":{"type":["string","null"],"examples":[null]},"longitude":{"type":["string","null"],"examples":[null]},"payment_authorization_id":{"type":["string","null"],"examples":[null]},"waitlist_notification_last_sent_at":{"type":["string","null"],"examples":[null]},"timesheet_status":{"type":"string","examples":["pending"]},"rating":{"type":["string","null"],"examples":[null]},"demand_expire":{"type":["string","null"],"examples":[null]},"deleted_at":{"type":["string","null"],"examples":[null]},"is_erased":{"type":"integer","examples":[0]},"created_at":{"type":"string","examples":["2026-06-09T05:36:42.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:42.000000Z"]},"deleted_by":{"type":["string","null"],"examples":[null]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20000:event_shift_user:3001"]},"journey_step":{"type":"string","examples":[""]},"journey_step_category":{"type":"string","examples":[""]},"created_at":{"type":"string","examples":["Jun 9, 2026, 5:36 AM"]},"created_at__date":{"type":"string","examples":["Jun 9, 2026"]},"created_at__time":{"type":"string","examples":["5:36 AM"]},"created_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"created_at__offset_minutes":{"type":"integer","examples":[0]},"created_at__dayofweek":{"type":"string","examples":["Tuesday"]},"event_shift_status_id":{"type":"string","examples":["Confirmed"]},"event_shift_status_id:value":{"type":"integer","examples":[3]},"event_shift_status_id:array":{"type":"string","examples":["Confirmed"]},"payment_authorization_id":{"type":"string","examples":[""]},"timesheet_status":{"type":"string","examples":["Pending"]},"timesheet_status:value":{"type":"string","examples":["pending"]},"timesheet_status:array":{"type":"string","examples":["Pending"]},"updated_at":{"type":"string","examples":["Jun 9, 2026, 5:36 AM"]},"updated_at__date":{"type":"string","examples":["Jun 9, 2026"]},"updated_at__time":{"type":"string","examples":["5:36 AM"]},"updated_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"updated_at__offset_minutes":{"type":"integer","examples":[0]},"updated_at__dayofweek":{"type":"string","examples":["Tuesday"]},"attended":{"type":"object","properties":{"seconds":{"type":"integer","examples":[0]},"minutes":{"type":"integer","examples":[0]},"hours":{"type":"integer","examples":[0]},"pretty":{"type":"string","examples":["00:00:00"]}}},"attended_without_checkout":{"type":"object","properties":{"seconds":{"type":"integer","examples":[0]},"minutes":{"type":"integer","examples":[0]},"hours":{"type":"integer","examples":[0]},"pretty":{"type":"string","examples":["00:00:00"]}}},"event_id":{"type":"integer","examples":[1001]},"event_name":{"type":"string","examples":["Example Event"]},"is_event_leader":{"type":"boolean","examples":[false]},"is_leader":{"type":"boolean","examples":[false]},"checkin_location":{"type":"array","examples":[[]]},"shift_name":{"type":"string","examples":["Example Shift"]},"user_name":{"type":"string","examples":["Example Volunteer"]},"requires_pre_checkin":{"type":"boolean","examples":[false]},"has_shift_attended_form":{"type":"boolean","examples":[false]},"has_checkin_form":{"type":"boolean","examples":[false]},"has_checkout_form":{"type":"boolean","examples":[false]},"shift_checkin_visible_attributes":{"type":"array","examples":[[]]},"has_confirmed":{"type":"boolean","examples":[true]},"has_rejected":{"type":"boolean","examples":[false]},"has_cancelled":{"type":"boolean","examples":[false]}}},"relations":{"type":"object","properties":{}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]},"status_update":{"type":"boolean","examples":[true]},"precheckin":{"type":"boolean","examples":[false]},"checkin":{"type":"boolean","examples":[true]},"checkout":{"type":"boolean","examples":[true]},"submitAttendedForm":{"type":"boolean","examples":[false]}}},"attributes":{"type":"object","properties":{}},"is_leader":{"type":"integer","examples":[0]}},"examples":[{"object":{"id":3001,"event_shift_id":2001,"user_id":1234,"post_shift_feedback_form_completed_at":null,"precheckin_form_completed_at":null,"event_shift_status_id":3,"demand":1,"break":null,"start_timestamp":null,"end_timestamp":null,"cost":"0.00","cost_meta":[],"meta":null,"latitude":null,"longitude":null,"payment_authorization_id":null,"waitlist_notification_last_sent_at":null,"timesheet_status":"pending","rating":null,"demand_expire":null,"deleted_at":null,"is_erased":0,"created_at":"2026-06-09T05:36:42.000000Z","updated_at":"2026-06-09T05:36:42.000000Z","deleted_by":null},"nice":{"rrn":"rrn:local:20000:event_shift_user:3001","journey_step":"","journey_step_category":"","created_at":"Jun 9, 2026, 5:36 AM","created_at__date":"Jun 9, 2026","created_at__time":"5:36 AM","created_at__offset":" (+00:00 UTC)","created_at__offset_minutes":0,"created_at__dayofweek":"Tuesday","event_shift_status_id":"Confirmed","event_shift_status_id:value":3,"event_shift_status_id:array":"Confirmed","payment_authorization_id":"","timesheet_status":"Pending","timesheet_status:value":"pending","timesheet_status:array":"Pending","updated_at":"Jun 9, 2026, 5:36 AM","updated_at__date":"Jun 9, 2026","updated_at__time":"5:36 AM","updated_at__offset":" (+00:00 UTC)","updated_at__offset_minutes":0,"updated_at__dayofweek":"Tuesday","attended":{"seconds":0,"minutes":0,"hours":0,"pretty":"00:00:00"},"attended_without_checkout":{"seconds":0,"minutes":0,"hours":0,"pretty":"00:00:00"},"event_id":1001,"event_name":"Example Event","is_event_leader":false,"is_leader":false,"checkin_location":[],"shift_name":"Example Shift","user_name":"Example Volunteer","requires_pre_checkin":false,"has_shift_attended_form":false,"has_checkin_form":false,"has_checkout_form":false,"shift_checkin_visible_attributes":[],"has_confirmed":true,"has_rejected":false,"has_cancelled":false},"relations":{},"permissions":{"read":true,"update":true,"delete":true,"status_update":true,"precheckin":false,"checkin":true,"checkout":true,"submitAttendedForm":false},"attributes":{},"is_leader":0}]},"id":"schema_423"},"schema_424":{"kind":"json-schema","data":{"type":"object","properties":{"event_shift_status_id":{"type":"integer","description":"The status the assignment starts at, or moves to. Must be one of the account's own shift statuses; a status the account treats as cancelled is refused.","examples":[3]},"is_leader":{"type":"boolean","description":"Whether this person leads the shift. Setting it on a shift that already has as many leaders as it allows returns a 405 - see the description.","examples":[true]},"feedback":{"type":"string","description":"A note about this person's performance on the shift. Kept only when the status being set is one the account treats as not approved, and discarded otherwise.","examples":[null]},"start_timestamp":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the person checked in, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DDTHH:MM"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Clearing it while an end time is still set is refused."},"children":[]}]}]}],"examples":[null]},"end_timestamp":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the person checked out, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DDTHH:MM"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"break":{"type":"number","description":"Unpaid break taken during the shift, in minutes. Subtracted from the attended time.","examples":[1.23]},"demand":{"type":"number","description":"How many places on the shift this assignment takes up. Defaults to 1. Cannot exceed the places the shift has left.","examples":[1]},"rating":{"type":"integer","description":"A rating for how the person performed on this shift, 0 to 5.","examples":[1]},"timesheet_status":{"type":"string","description":"Where the assignment sits in timesheet approval.","examples":["pending"]},"repeat":{"type":"boolean","description":"Apply the same change to this person's assignments on every later shift linked to this one. Only meaningful on a shift that belongs to a linked series.","examples":[true]},"custom_*":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A custom attribute, named by its code - custom_shirt_size, for example. The value follows the attribute's own type, so it may be a string, a number, a boolean or a list. See the custom attributes documentation."},"children":[]}]}]}],"examples":[null]}}},"id":"schema_424"},"schema_425":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","examples":["Do you want to update all linked Shifts after this one that have the same status?"]},"reference":{"type":"string","examples":["repeat"]}},"examples":[{"message":"Do you want to update all linked Shifts after this one that have the same status?","reference":"repeat"}]},"id":"schema_425"},"schema_426":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","examples":["Leader demand is already full for this Shift. Would you like to increase the leader demand?"]},"reference":{"type":"string","examples":["override_system_limits.event.shift.leader.demand"]}},"examples":[{"message":"Leader demand is already full for this Shift. Would you like to increase the leader demand?","reference":"override_system_limits.event.shift.leader.demand"}]},"id":"schema_426"},"schema_427":{"kind":"json-schema","data":{"type":"object","properties":{"repeat":{"type":"boolean","description":"Apply the same change to this person's assignments on every later shift linked to this one. Only meaningful on a shift that belongs to a linked series.","examples":[true]}}},"id":"schema_427"},"schema_428":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","examples":["Do you want to delete this User from all linked Shifts after this one?"]},"reference":{"type":"string","examples":["repeat"]}},"examples":[{"message":"Do you want to delete this User from all linked Shifts after this one?","reference":"repeat"}]},"id":"schema_428"},"schema_429":{"kind":"json-schema","data":{"type":"array","items":{"type":"object","properties":{"current_page":{"type":"integer","examples":[1]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[3001]},"event_shift_id":{"type":"integer","examples":[2001]},"user_id":{"type":"integer","examples":[1234]},"post_shift_feedback_form_completed_at":{"type":["string","null"],"examples":[null]},"precheckin_form_completed_at":{"type":["string","null"],"examples":[null]},"event_shift_status_id":{"type":"integer","examples":[3]},"demand":{"type":"integer","examples":[1]},"break":{"type":["string","null"],"examples":[null]},"start_timestamp":{"type":["string","null"],"examples":[null]},"end_timestamp":{"type":["string","null"],"examples":[null]},"cost":{"type":"string","examples":["0.00"]},"cost_meta":{"type":"array","examples":[[]]},"meta":{"type":["string","null"],"examples":[null]},"latitude":{"type":["string","null"],"examples":[null]},"longitude":{"type":["string","null"],"examples":[null]},"payment_authorization_id":{"type":["string","null"],"examples":[null]},"waitlist_notification_last_sent_at":{"type":["string","null"],"examples":[null]},"timesheet_status":{"type":"string","examples":["pending"]},"rating":{"type":["string","null"],"examples":[null]},"demand_expire":{"type":["string","null"],"examples":[null]},"deleted_at":{"type":["string","null"],"examples":[null]},"is_erased":{"type":"integer","examples":[0]},"created_at":{"type":"string","examples":["2026-06-09T05:36:42.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:42.000000Z"]},"deleted_by":{"type":["string","null"],"examples":[null]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20000:event_shift_user:3001"]},"journey_step":{"type":"string","examples":[""]},"journey_step_category":{"type":"string","examples":[""]},"created_at":{"type":"string","examples":["Jun 9, 2026, 5:36 AM"]},"created_at__date":{"type":"string","examples":["Jun 9, 2026"]},"created_at__time":{"type":"string","examples":["5:36 AM"]},"created_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"created_at__offset_minutes":{"type":"integer","examples":[0]},"created_at__dayofweek":{"type":"string","examples":["Tuesday"]},"event_shift_status_id":{"type":"string","examples":["Confirmed"]},"event_shift_status_id:value":{"type":"integer","examples":[3]},"event_shift_status_id:array":{"type":"string","examples":["Confirmed"]},"payment_authorization_id":{"type":"string","examples":[""]},"timesheet_status":{"type":"string","examples":["Pending"]},"timesheet_status:value":{"type":"string","examples":["pending"]},"timesheet_status:array":{"type":"string","examples":["Pending"]},"updated_at":{"type":"string","examples":["Jun 9, 2026, 5:36 AM"]},"updated_at__date":{"type":"string","examples":["Jun 9, 2026"]},"updated_at__time":{"type":"string","examples":["5:36 AM"]},"updated_at__offset":{"type":"string","examples":[" (+00:00 UTC)"]},"updated_at__offset_minutes":{"type":"integer","examples":[0]},"updated_at__dayofweek":{"type":"string","examples":["Tuesday"]},"attended":{"type":"object","properties":{"seconds":{"type":"integer","examples":[0]},"minutes":{"type":"integer","examples":[0]},"hours":{"type":"integer","examples":[0]},"pretty":{"type":"string","examples":["00:00:00"]}}},"attended_without_checkout":{"type":"object","properties":{"seconds":{"type":"integer","examples":[0]},"minutes":{"type":"integer","examples":[0]},"hours":{"type":"integer","examples":[0]},"pretty":{"type":"string","examples":["00:00:00"]}}},"event_id":{"type":"integer","examples":[1001]},"event_name":{"type":"string","examples":["Example Event"]},"is_event_leader":{"type":"boolean","examples":[false]},"is_leader":{"type":"boolean","examples":[false]},"checkin_location":{"type":"array","examples":[[]]},"shift_name":{"type":"string","examples":["Example Shift"]},"user_name":{"type":"string","examples":["Example Volunteer"]},"requires_pre_checkin":{"type":"boolean","examples":[false]},"has_shift_attended_form":{"type":"boolean","examples":[false]},"has_checkin_form":{"type":"boolean","examples":[false]},"has_checkout_form":{"type":"boolean","examples":[false]},"shift_checkin_visible_attributes":{"type":"array","examples":[[]]},"has_confirmed":{"type":"boolean","examples":[true]},"has_rejected":{"type":"boolean","examples":[false]},"has_cancelled":{"type":"boolean","examples":[false]}}},"relations":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]},"status_update":{"type":"boolean","examples":[true]},"precheckin":{"type":"boolean","examples":[false]},"checkin":{"type":"boolean","examples":[true]},"checkout":{"type":"boolean","examples":[true]},"submitAttendedForm":{"type":"boolean","examples":[false]}}},"attributes":{"type":"array","examples":[[]]},"is_leader":{"type":"integer","examples":[0]}}},"examples":[[{"object":{"id":3001,"event_shift_id":2001,"user_id":1234,"post_shift_feedback_form_completed_at":null,"precheckin_form_completed_at":null,"event_shift_status_id":3,"demand":1,"break":null,"start_timestamp":null,"end_timestamp":null,"cost":"0.00","cost_meta":[],"meta":null,"latitude":null,"longitude":null,"payment_authorization_id":null,"waitlist_notification_last_sent_at":null,"timesheet_status":"pending","rating":null,"demand_expire":null,"deleted_at":null,"is_erased":0,"created_at":"2026-06-09T05:36:42.000000Z","updated_at":"2026-06-09T05:36:42.000000Z","deleted_by":null},"nice":{"rrn":"rrn:local:20000:event_shift_user:3001","journey_step":"","journey_step_category":"","created_at":"Jun 9, 2026, 5:36 AM","created_at__date":"Jun 9, 2026","created_at__time":"5:36 AM","created_at__offset":" (+00:00 UTC)","created_at__offset_minutes":0,"created_at__dayofweek":"Tuesday","event_shift_status_id":"Confirmed","event_shift_status_id:value":3,"event_shift_status_id:array":"Confirmed","payment_authorization_id":"","timesheet_status":"Pending","timesheet_status:value":"pending","timesheet_status:array":"Pending","updated_at":"Jun 9, 2026, 5:36 AM","updated_at__date":"Jun 9, 2026","updated_at__time":"5:36 AM","updated_at__offset":" (+00:00 UTC)","updated_at__offset_minutes":0,"updated_at__dayofweek":"Tuesday","attended":{"seconds":0,"minutes":0,"hours":0,"pretty":"00:00:00"},"attended_without_checkout":{"seconds":0,"minutes":0,"hours":0,"pretty":"00:00:00"},"event_id":1001,"event_name":"Example Event","is_event_leader":false,"is_leader":false,"checkin_location":[],"shift_name":"Example Shift","user_name":"Example Volunteer","requires_pre_checkin":false,"has_shift_attended_form":false,"has_checkin_form":false,"has_checkout_form":false,"shift_checkin_visible_attributes":[],"has_confirmed":true,"has_rejected":false,"has_cancelled":false},"relations":[],"permissions":{"read":true,"update":true,"delete":true,"status_update":true,"precheckin":false,"checkin":true,"checkout":true,"submitAttendedForm":false},"attributes":[],"is_leader":0},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}]]},"first_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/event/shift/user?per_page=5&_locale=en-US&page=1"]},"from":{"type":"integer","examples":[1]},"next_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/event/shift/user?per_page=5&_locale=en-US&page=2"]},"path":{"type":"string","examples":["https://example.rosterfy.com/api/v2/event/shift/user"]},"per_page":{"type":"integer","examples":[5]},"prev_page_url":{"type":["string","null"],"examples":[null]},"to":{"type":"integer","examples":[5]}}},"examples":[[{"current_page":1,"data":[{"object":{"id":3001,"event_shift_id":2001,"user_id":1234,"post_shift_feedback_form_completed_at":null,"precheckin_form_completed_at":null,"event_shift_status_id":3,"demand":1,"break":null,"start_timestamp":null,"end_timestamp":null,"cost":"0.00","cost_meta":[],"meta":null,"latitude":null,"longitude":null,"payment_authorization_id":null,"waitlist_notification_last_sent_at":null,"timesheet_status":"pending","rating":null,"demand_expire":null,"deleted_at":null,"is_erased":0,"created_at":"2026-06-09T05:36:42.000000Z","updated_at":"2026-06-09T05:36:42.000000Z","deleted_by":null},"nice":{"rrn":"rrn:local:20000:event_shift_user:3001","journey_step":"","journey_step_category":"","created_at":"Jun 9, 2026, 5:36 AM","created_at__date":"Jun 9, 2026","created_at__time":"5:36 AM","created_at__offset":" (+00:00 UTC)","created_at__offset_minutes":0,"created_at__dayofweek":"Tuesday","event_shift_status_id":"Confirmed","event_shift_status_id:value":3,"event_shift_status_id:array":"Confirmed","payment_authorization_id":"","timesheet_status":"Pending","timesheet_status:value":"pending","timesheet_status:array":"Pending","updated_at":"Jun 9, 2026, 5:36 AM","updated_at__date":"Jun 9, 2026","updated_at__time":"5:36 AM","updated_at__offset":" (+00:00 UTC)","updated_at__offset_minutes":0,"updated_at__dayofweek":"Tuesday","attended":{"seconds":0,"minutes":0,"hours":0,"pretty":"00:00:00"},"attended_without_checkout":{"seconds":0,"minutes":0,"hours":0,"pretty":"00:00:00"},"event_id":1001,"event_name":"Example Event","is_event_leader":false,"is_leader":false,"checkin_location":[],"shift_name":"Example Shift","user_name":"Example Volunteer","requires_pre_checkin":false,"has_shift_attended_form":false,"has_checkin_form":false,"has_checkout_form":false,"shift_checkin_visible_attributes":[],"has_confirmed":true,"has_rejected":false,"has_cancelled":false},"relations":[],"permissions":{"read":true,"update":true,"delete":true,"status_update":true,"precheckin":false,"checkin":true,"checkout":true,"submitAttendedForm":false},"attributes":[],"is_leader":0},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}],"first_page_url":"https://example.rosterfy.com/api/v2/event/shift/user?per_page=5&_locale=en-US&page=1","from":1,"next_page_url":"https://example.rosterfy.com/api/v2/event/shift/user?per_page=5&_locale=en-US&page=2","path":"https://example.rosterfy.com/api/v2/event/shift/user","per_page":5,"prev_page_url":null,"to":5}]]},"id":"schema_429"},"schema_430":{"kind":"json-schema","data":{"type":"object","properties":{"event_shift_status_id":{"type":"integer","description":"The status the assignment starts at, or moves to. Must be one of the account's own shift statuses; a status the account treats as cancelled is refused.","examples":[1]},"start_timestamp":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the person checked in, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DDTHH:MM"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Clearing it while an end time is still set is refused."},"children":[]}]}]}],"examples":[null]},"end_timestamp":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the person checked out, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DDTHH:MM"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"break":{"type":"number","description":"Unpaid break taken during the shift, in minutes. Subtracted from the attended time.","examples":[1.23]},"is_leader":{"type":"boolean","description":"Whether this person leads the shift. Setting it on a shift that already has as many leaders as it allows returns a 405 - see the description.","examples":[true]},"repeat":{"type":"boolean","description":"Apply the same change to this person's assignments on every later shift linked to this one. Only meaningful on a shift that belongs to a linked series.","examples":[true]},"event_shift_id":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The shift to add people to. Read "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"only"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/event/{event_id}/shift/user/mass-create"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and only from the query string - see the description. Ignored on the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/event/{event_id}/shift/{shift_id}/user/mass-create"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" form, which takes the shift from the URL."},"children":[]}]}]}],"examples":[1]},"applyTo":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to act only on the records named in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Any other value acts on everything the caller can see, narrowed by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filter"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if one is sent. The value is not checked against a list, so a typo is accepted and treated as \"everything\"."},"children":[]}]}]}],"examples":[null]},"selected":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The IDs to act on. On the mass add these are user IDs; on the mass delete they are shift assignment IDs. Required in practice when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"applyTo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", but nothing validates that: omitting it still returns a queue token and the background work then does nothing."},"children":[]}]}]}],"items":{"type":"integer"},"examples":[[]]},"filter":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The same filter object the listings take, used to choose the records to act on when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"applyTo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"items":{"type":"string"},"examples":[[]]},"swap_from_shift_id":{"type":"integer","description":"Move everyone selected off this shift as part of the same request.","examples":[1]}},"required":["event_shift_status_id"]},"id":"schema_430"},"schema_431":{"kind":"json-schema","data":{"type":"object","properties":{"applyTo":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to act only on the records named in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Any other value acts on everything the caller can see, narrowed by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filter"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if one is sent. The value is not checked against a list, so a typo is accepted and treated as \"everything\"."},"children":[]}]}]}],"examples":[null]},"selected":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The IDs to act on. On the mass add these are user IDs; on the mass delete they are shift assignment IDs. Required in practice when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"applyTo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", but nothing validates that: omitting it still returns a queue token and the background work then does nothing."},"children":[]}]}]}],"items":{"type":"integer"},"examples":[[]]},"filter":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The same filter object the listings take, used to choose the records to act on when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"applyTo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"items":{"type":"string"},"examples":[[]]}},"required":["applyTo"]},"id":"schema_431"},"schema_432":{"kind":"json-schema","data":{"type":"object","properties":{"shifts":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The shifts to apply for, one object per shift. The rule says only \"array\", so the shape of an entry is stated here rather than in the schema. Every entry takes: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"event_shift_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (integer, "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"required"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") the shift being applied for; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"leader_applied"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (0 or 1, "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"required"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on every entry even when it is 0) whether the application is to lead the shift; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"application_form"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (object, optional) the answers to that shift's application form, keyed by the field codes your account configured; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"linked"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (boolean, optional) also join the linked series the shift belongs to, so the person is put on its other shifts; and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"in_cart"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (boolean, optional) which marks an entry as already in the cart and is ignored here - every entry is applied for whether or not it is set. An entry missing "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"event_shift_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"leader_applied"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is refused with \"Incorrect data structure\" against "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"shifts"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and no application is made for any of them."},"children":[]}]}]}],"items":{"type":"object"},"examples":[[{"event_shift_id":2001,"leader_applied":0},{"event_shift_id":2002,"leader_applied":1,"linked":true,"application_form":{"user:first_name":"Example","user:last_name":"Volunteer"}}]]},"paymentData":{"type":"object","description":"Payment details for shifts that cost money. Read only when the account has a payment provider configured, and ignored otherwise. The keys are the provider's own; a failed payment removes the applications it was for.","properties":{},"examples":[[]]}},"required":["shifts"]},"id":"schema_432"},"schema_433":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","examples":[""]},"errors":{"type":"array","items":{"type":"object","properties":{"event_shift_id":{"type":"integer","examples":[2001]},"message":{"type":"string","examples":["Unable to apply to this Shift"]}}},"examples":[[{"event_shift_id":2001,"message":"Unable to apply to this Shift"}]]}},"examples":[{"message":"","errors":[{"event_shift_id":2001,"message":"Unable to apply to this Shift"}]}]},"id":"schema_433"},"schema_434":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","examples":["User exists in that Shift"]}},"examples":[{"message":"User exists in that Shift"}]},"id":"schema_434"},"schema_435":{"kind":"json-schema","data":{"type":"object","properties":{"asLeader":{"type":"boolean","description":"Check whether the person can lead this shift rather than take an ordinary place on it. The name is camelCase because that is what the endpoint reads.","examples":[true]}}},"id":"schema_435"},"schema_436":{"kind":"json-schema","data":{"type":"object","properties":{"user:first_name":{"type":"string","examples":["Example"]},"user:last_name":{"type":"string","examples":["Volunteer"]},"user:email":{"type":"string","examples":["volunteer@example.com"]},"user:dob":{"type":"string","examples":["1990-01-01"]},"user:terms":{"type":"integer","examples":[1]},"user:custom_multiselect_attribute":{"type":["string","null"],"examples":[null]}},"examples":[{"user:first_name":"Example","user:last_name":"Volunteer","user:email":"volunteer@example.com","user:dob":"1990-01-01","user:terms":1,"user:custom_multiselect_attribute":null}]},"id":"schema_436"},"schema_437":{"kind":"json-schema","data":{"type":"array","description":"A list of extras to include in the response. These are objects or arrays that are not part of\nthe model's primary attributes, such as stats and counts.\nFor fast responses, avoid requesting them if you don't need them. ","items":{"type":"string","enum":["stats","upcoming_shift_attributes","certificate_stats"]},"examples":[["stats"]]},"id":"schema_437"},"schema_438":{"kind":"json-schema","data":{"type":"array","description":"A list of relations to include in the response. May be single records or collections.\nIt is often more efficient to retrieve this way, to avoid follow-up API calls.","items":{"type":"string","enum":["location_type","hasManyDeepFromRelationsWithConstraints","hasOneDeepFromRelationsWithConstraints","hasManyDeepFromReverse","hasOneDeepFromReverse"]},"examples":[["location_type"]]},"id":"schema_438"},"schema_439":{"kind":"json-schema","data":{"type":"array","items":{"type":"object","properties":{"current_page":{"type":"integer","examples":[1]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[2001]},"event_id":{"type":"integer","examples":[1001]},"event_shift_type_id":{"type":["string","null"],"examples":[null]},"event_shift_template_id":{"type":["string","null"],"examples":[null]},"journey_id":{"type":["string","null"],"examples":[null]},"min_demand":{"type":"integer","examples":[10]},"max_demand":{"type":"integer","examples":[10]},"leader_demand":{"type":"integer","examples":[1]},"start_timestamp":{"type":"string","examples":["2026-09-17 05:00:00"]},"end_timestamp":{"type":"string","examples":["2026-09-17 13:00:00"]},"timezone":{"type":"string","examples":["Australia/Melbourne"]},"no_shift_time":{"type":"integer","examples":[0]},"apps_open_timestamp":{"type":["string","null"],"examples":[null]},"apps_close_timestamp":{"type":["string","null"],"examples":[null]},"headcount_location_venue_id":{"type":["string","null"],"examples":[null]},"shift_confirmed_status_default":{"type":"integer","examples":[3]},"shift_rejected_status_default":{"type":"integer","examples":[6]},"journey_complete_status":{"type":["string","null"],"examples":[null]},"shift_can_withdraw_default":{"type":"integer","examples":[1]},"shift_can_confirm":{"type":"integer","examples":[1]},"shift_can_confirm_limit":{"type":"integer","examples":[0]},"shift_can_withdraw_limit":{"type":"integer","examples":[0]},"shift_checked_in_status_default":{"type":"integer","examples":[4]},"shift_checked_out_status_default":{"type":"integer","examples":[4]},"certificate_id":{"type":["string","null"],"examples":[null]},"shift_application_form_id":{"type":["string","null"],"examples":[null]},"allow_application_form_resubmit":{"type":"integer","examples":[0]},"shift_checkin_form_id":{"type":["string","null"],"examples":[null]},"shift_attended_form_id":{"type":["string","null"],"examples":[null]},"shift_checkout_form_id":{"type":["string","null"],"examples":[null]},"shift_precheckin_form_id":{"type":["string","null"],"examples":[null]},"shift_withdraw_form_id":{"type":["string","null"],"examples":[null]},"training_ids":{"type":["string","null"],"examples":[null]},"visibility_show_groups":{"type":"array","examples":[[]]},"visibility_hide_groups":{"type":"array","examples":[[]]},"visibility_show_roleoffer":{"type":"array","examples":[[]]},"role_offer_id":{"type":["string","null"],"examples":[null]},"role_offer_address":{"type":"integer","examples":[0]},"checkin_visible_attributes":{"type":"array","examples":[[]]},"shift_enable_waitlist_default":{"type":"integer","examples":[0]},"max_waitlist":{"type":"integer","examples":[0]},"group_booking_ttl":{"type":["string","null"],"examples":[null]},"max_group_demand":{"type":["string","null"],"examples":[null]},"max_group_size":{"type":["string","null"],"examples":[null]},"reserved_expiry":{"type":["string","null"],"examples":[null]},"minimum_dob":{"type":["string","null"],"examples":[null]},"minimum_age":{"type":["string","null"],"examples":[null]},"maximum_dob":{"type":["string","null"],"examples":[null]},"maximum_age":{"type":["string","null"],"examples":[null]},"self_checkin":{"type":"integer","examples":[0]},"self_checkin_open":{"type":"integer","examples":[1800]},"self_checkin_close":{"type":"integer","examples":[1800]},"self_checkout_close":{"type":"integer","examples":[1800]},"checkin_close":{"type":"integer","examples":[0]},"shift_precheckin_open":{"type":"integer","examples":[0]},"break":{"type":"integer","examples":[0]},"post_feedback_form":{"type":["string","null"],"examples":[null]},"shift_leader_feedback_form_id":{"type":["string","null"],"examples":[null]},"is_virtual":{"type":"integer","examples":[0]},"geofence_checkin_limit":{"type":["string","null"],"examples":[null]},"tax":{"type":["string","null"],"examples":[null]},"price_excluding_tax":{"type":"integer","examples":[0]},"tax_percentage":{"type":["string","null"],"examples":[null]},"publish":{"type":"integer","examples":[0]},"public":{"type":"integer","examples":[0]},"sort_order":{"type":"integer","examples":[0]},"is_cancelled":{"type":"integer","examples":[0]},"deleted_at":{"type":["string","null"],"examples":[null]},"is_erased":{"type":"integer","examples":[0]},"is_draft":{"type":"boolean","examples":[false]},"created_at":{"type":"string","examples":["2026-06-09T05:36:10.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:10.000000Z"]},"deleted_by":{"type":["string","null"],"examples":[null]},"address":{"type":"object","properties":{"iso":{"type":"string","examples":["AUS"]},"region_code":{"type":"string","examples":["VIC"]},"coordinates":{"type":"object","properties":{"latitude":{"type":"string","examples":["-37.814000"]},"longitude":{"type":"string","examples":["144.963100"]}}},"street_address_1":{"type":"string","examples":["1 Example Street"]},"street_address_2":{"type":["string","null"],"examples":[null]},"street_address_3":{"type":["string","null"],"examples":[null]},"city":{"type":"string","examples":["Melbourne"]},"postcode":{"type":"string","examples":["3000"]},"region":{"type":"string","examples":["VIC"]},"country":{"type":"string","examples":["AU"]},"latitude":{"type":"string","examples":["-37.814000"]},"longitude":{"type":"string","examples":["144.963100"]}}}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:example:20000:shift:2001"]},"address":{"type":"string","examples":["1 Example Street\nMelbourne\nVictoria\nAustralia\n3000"]},"address_oneline":{"type":"string","examples":["1 Example Street, Melbourne, Victoria, Australia, 3000"]},"address.country":{"type":"string","examples":["Australia"]},"address.country:raw":{"type":"string","examples":["AUS"]},"address.city":{"type":"string","examples":["Melbourne"]},"address.region":{"type":"string","examples":["Victoria"]},"address.region:raw":{"type":"string","examples":["VIC"]},"address.postcode":{"type":"string","examples":["3000"]},"address.street_address_1":{"type":"string","examples":["1 Example Street"]},"address.street_address_2":{"type":"string","examples":[""]},"address.street_address_3":{"type":"string","examples":[""]},"address.latitude":{"type":"string","examples":["-37.814000"]},"address.longitude":{"type":"string","examples":["144.963100"]},"created_at":{"type":"string","examples":["Jun 9, 2026, 3:36 PM"]},"created_at__date":{"type":"string","examples":["Jun 9, 2026"]},"created_at__time":{"type":"string","examples":["3:36 PM"]},"created_at__offset":{"type":"string","examples":[" (+10:00 AEST)"]},"created_at__offset_minutes":{"type":"integer","examples":[600]},"created_at__dayofweek":{"type":"string","examples":["Tuesday"]},"end_timestamp":{"type":"string","examples":["Sep 17, 2026, 11:00 PM"]},"end_timestamp__date":{"type":"string","examples":["Sep 17, 2026"]},"end_timestamp__time":{"type":"string","examples":["11:00 PM"]},"end_timestamp__offset":{"type":"string","examples":[" (+10:00 AEST)"]},"end_timestamp__offset_minutes":{"type":"integer","examples":[600]},"end_timestamp__dayofweek":{"type":"string","examples":["Thursday"]},"event_shift_template_id":{"type":["string","null"],"examples":[null]},"event_shift_template_id:value":{"type":["string","null"],"examples":[null]},"event_shift_template_id:array":{"type":["string","null"],"examples":[null]},"event_shift_type_id":{"type":["string","null"],"examples":[null]},"event_shift_type_id:value":{"type":["string","null"],"examples":[null]},"event_shift_type_id:array":{"type":["string","null"],"examples":[null]},"headcount_location_venue_id":{"type":["string","null"],"examples":[null]},"headcount_location_venue_id:value":{"type":["string","null"],"examples":[null]},"headcount_location_venue_id:array":{"type":["string","null"],"examples":[null]},"is_virtual":{"type":"string","examples":["No"]},"minimum_age":{"type":"string","examples":[""]},"name":{"type":"string","examples":[""]},"no_shift_time":{"type":"string","examples":["No"]},"post_feedback_form":{"type":["string","null"],"examples":[null]},"post_feedback_form:value":{"type":["string","null"],"examples":[null]},"post_feedback_form:array":{"type":["string","null"],"examples":[null]},"public":{"type":"string","examples":["No"]},"publish":{"type":"string","examples":["No"]},"role_offer_address":{"type":"string","examples":["No"]},"role_offer_id":{"type":["string","null"],"examples":[null]},"role_offer_id:value":{"type":["string","null"],"examples":[null]},"role_offer_id:array":{"type":["string","null"],"examples":[null]},"self_checkin":{"type":"string","examples":["No"]},"shift_application_form_id":{"type":["string","null"],"examples":[null]},"shift_application_form_id:value":{"type":["string","null"],"examples":[null]},"shift_application_form_id:array":{"type":["string","null"],"examples":[null]},"shift_attended_form_id":{"type":["string","null"],"examples":[null]},"shift_attended_form_id:value":{"type":["string","null"],"examples":[null]},"shift_attended_form_id:array":{"type":["string","null"],"examples":[null]},"shift_checkin_form_id":{"type":["string","null"],"examples":[null]},"shift_checkin_form_id:value":{"type":["string","null"],"examples":[null]},"shift_checkin_form_id:array":{"type":["string","null"],"examples":[null]},"shift_checkout_form_id":{"type":["string","null"],"examples":[null]},"shift_checkout_form_id:value":{"type":["string","null"],"examples":[null]},"shift_checkout_form_id:array":{"type":["string","null"],"examples":[null]},"shift_precheckin_form_id":{"type":["string","null"],"examples":[null]},"shift_precheckin_form_id:value":{"type":["string","null"],"examples":[null]},"shift_precheckin_form_id:array":{"type":["string","null"],"examples":[null]},"shift_withdraw_form_id":{"type":["string","null"],"examples":[null]},"shift_withdraw_form_id:value":{"type":["string","null"],"examples":[null]},"shift_withdraw_form_id:array":{"type":["string","null"],"examples":[null]},"start_timestamp":{"type":"string","examples":["Sep 17, 2026, 3:00 PM"]},"start_timestamp__date":{"type":"string","examples":["Sep 17, 2026"]},"start_timestamp__time":{"type":"string","examples":["3:00 PM"]},"start_timestamp__offset":{"type":"string","examples":[" (+10:00 AEST)"]},"start_timestamp__offset_minutes":{"type":"integer","examples":[600]},"start_timestamp__dayofweek":{"type":"string","examples":["Thursday"]},"updated_at":{"type":"string","examples":["Jun 9, 2026, 3:36 PM"]},"updated_at__date":{"type":"string","examples":["Jun 9, 2026"]},"updated_at__time":{"type":"string","examples":["3:36 PM"]},"updated_at__offset":{"type":"string","examples":[" (+10:00 AEST)"]},"updated_at__offset_minutes":{"type":"integer","examples":[600]},"updated_at__dayofweek":{"type":"string","examples":["Tuesday"]},"visibility_hide_groups":{"type":"string","examples":[""]},"visibility_show_groups":{"type":"string","examples":[""]},"visibility_show_roleoffer":{"type":"string","examples":[""]},"info":{"type":"string","examples":[" - "]},"event_shift_link_id":{"type":"integer","examples":[1]},"event_shift_link_repeat":{"type":"integer","examples":[1]},"event_shift_link_name":{"type":"string","examples":["test shift link"]},"shift_status_default_id":{"type":"integer","examples":[1]},"length":{"type":"integer","examples":[8]},"account_id":{"type":"integer","examples":[20000]},"account_url":{"type":"string","examples":["https://example.rosterfy.com/"]},"is_any_leader":{"type":"boolean","examples":[false]},"post_shift_feedback_form_completed_at":{"type":"string","examples":[""]},"pre_checkin_form_completed_at":{"type":"string","examples":[""]},"event_name":{"type":["string","null"],"examples":[null]}}},"relations":{"type":"object","properties":{"pivot":{"type":"object","properties":{"event_shift_link_id":{"type":"integer","examples":[3001]},"event_shift_id":{"type":"integer","examples":[2001]}}}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]},"apply":{"type":"boolean","examples":[false]},"apply_error":{"type":"string","examples":["Shift applications not open"]},"apply_error_code":{"type":"string","examples":["ES0056"]},"is_unavailable":{"type":"boolean","examples":[false]},"confirm":{"type":"boolean","examples":[false]},"reject":{"type":"boolean","examples":[false]},"selfCheckin":{"type":"boolean","examples":[false]},"selfCheckout":{"type":"boolean","examples":[false]},"submitAttendedForm":{"type":"boolean","examples":[false]},"precheckin":{"type":"boolean","examples":[false]},"applyWaitlist":{"type":"boolean","examples":[false]}}},"attributes":{"type":"array","examples":[[]]}}},"examples":[[{"object":{"id":2001,"event_id":1001,"event_shift_type_id":null,"event_shift_template_id":null,"journey_id":null,"min_demand":10,"max_demand":10,"leader_demand":1,"start_timestamp":"2026-09-17 05:00:00","end_timestamp":"2026-09-17 13:00:00","timezone":"Australia/Melbourne","no_shift_time":0,"apps_open_timestamp":null,"apps_close_timestamp":null,"headcount_location_venue_id":null,"shift_confirmed_status_default":3,"shift_rejected_status_default":6,"journey_complete_status":null,"shift_can_withdraw_default":1,"shift_can_confirm":1,"shift_can_confirm_limit":0,"shift_can_withdraw_limit":0,"shift_checked_in_status_default":4,"shift_checked_out_status_default":4,"certificate_id":null,"shift_application_form_id":null,"allow_application_form_resubmit":0,"shift_checkin_form_id":null,"shift_attended_form_id":null,"shift_checkout_form_id":null,"shift_precheckin_form_id":null,"shift_withdraw_form_id":null,"training_ids":null,"visibility_show_groups":[],"visibility_hide_groups":[],"visibility_show_roleoffer":[],"role_offer_id":null,"role_offer_address":0,"checkin_visible_attributes":[],"shift_enable_waitlist_default":0,"max_waitlist":0,"group_booking_ttl":null,"max_group_demand":null,"max_group_size":null,"reserved_expiry":null,"minimum_dob":null,"minimum_age":null,"maximum_dob":null,"maximum_age":null,"self_checkin":0,"self_checkin_open":1800,"self_checkin_close":1800,"self_checkout_close":1800,"checkin_close":0,"shift_precheckin_open":0,"break":0,"post_feedback_form":null,"shift_leader_feedback_form_id":null,"is_virtual":0,"geofence_checkin_limit":null,"tax":null,"price_excluding_tax":0,"tax_percentage":null,"publish":0,"public":0,"sort_order":0,"is_cancelled":0,"deleted_at":null,"is_erased":0,"is_draft":false,"created_at":"2026-06-09T05:36:10.000000Z","updated_at":"2026-06-09T05:36:10.000000Z","deleted_by":null,"address":{"iso":"AUS","region_code":"VIC","coordinates":{"latitude":"-37.814000","longitude":"144.963100"},"street_address_1":"1 Example Street","street_address_2":null,"street_address_3":null,"city":"Melbourne","postcode":"3000","region":"VIC","country":"AU","latitude":"-37.814000","longitude":"144.963100"}},"nice":{"rrn":"rrn:example:20000:shift:2001","address":"1 Example Street\nMelbourne\nVictoria\nAustralia\n3000","address_oneline":"1 Example Street, Melbourne, Victoria, Australia, 3000","address.country":"Australia","address.country:raw":"AUS","address.city":"Melbourne","address.region":"Victoria","address.region:raw":"VIC","address.postcode":"3000","address.street_address_1":"1 Example Street","address.street_address_2":"","address.street_address_3":"","address.latitude":"-37.814000","address.longitude":"144.963100","created_at":"Jun 9, 2026, 3:36 PM","created_at__date":"Jun 9, 2026","created_at__time":"3:36 PM","created_at__offset":" (+10:00 AEST)","created_at__offset_minutes":600,"created_at__dayofweek":"Tuesday","end_timestamp":"Sep 17, 2026, 11:00 PM","end_timestamp__date":"Sep 17, 2026","end_timestamp__time":"11:00 PM","end_timestamp__offset":" (+10:00 AEST)","end_timestamp__offset_minutes":600,"end_timestamp__dayofweek":"Thursday","event_shift_template_id":null,"event_shift_template_id:value":null,"event_shift_template_id:array":null,"event_shift_type_id":null,"event_shift_type_id:value":null,"event_shift_type_id:array":null,"headcount_location_venue_id":null,"headcount_location_venue_id:value":null,"headcount_location_venue_id:array":null,"is_virtual":"No","minimum_age":"","name":"","no_shift_time":"No","post_feedback_form":null,"post_feedback_form:value":null,"post_feedback_form:array":null,"public":"No","publish":"No","role_offer_address":"No","role_offer_id":null,"role_offer_id:value":null,"role_offer_id:array":null,"self_checkin":"No","shift_application_form_id":null,"shift_application_form_id:value":null,"shift_application_form_id:array":null,"shift_attended_form_id":null,"shift_attended_form_id:value":null,"shift_attended_form_id:array":null,"shift_checkin_form_id":null,"shift_checkin_form_id:value":null,"shift_checkin_form_id:array":null,"shift_checkout_form_id":null,"shift_checkout_form_id:value":null,"shift_checkout_form_id:array":null,"shift_precheckin_form_id":null,"shift_precheckin_form_id:value":null,"shift_precheckin_form_id:array":null,"shift_withdraw_form_id":null,"shift_withdraw_form_id:value":null,"shift_withdraw_form_id:array":null,"start_timestamp":"Sep 17, 2026, 3:00 PM","start_timestamp__date":"Sep 17, 2026","start_timestamp__time":"3:00 PM","start_timestamp__offset":" (+10:00 AEST)","start_timestamp__offset_minutes":600,"start_timestamp__dayofweek":"Thursday","updated_at":"Jun 9, 2026, 3:36 PM","updated_at__date":"Jun 9, 2026","updated_at__time":"3:36 PM","updated_at__offset":" (+10:00 AEST)","updated_at__offset_minutes":600,"updated_at__dayofweek":"Tuesday","visibility_hide_groups":"","visibility_show_groups":"","visibility_show_roleoffer":"","info":" - ","event_shift_link_id":1,"event_shift_link_repeat":1,"event_shift_link_name":"test shift link","shift_status_default_id":1,"length":8,"account_id":20000,"account_url":"https://example.rosterfy.com/","is_any_leader":false,"post_shift_feedback_form_completed_at":"","pre_checkin_form_completed_at":"","event_name":null},"relations":{"pivot":{"event_shift_link_id":3001,"event_shift_id":2001}},"permissions":{"read":true,"update":true,"delete":true,"apply":false,"apply_error":"Shift applications not open","apply_error_code":"ES0056","is_unavailable":false,"confirm":false,"reject":false,"selfCheckin":false,"selfCheckout":false,"submitAttendedForm":false,"precheckin":false,"applyWaitlist":false},"attributes":[]},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}]]},"first_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/event/{event}/shift/link/{link}/shift?per_page=5&_locale=en-US&page=1"]},"from":{"type":"integer","examples":[1]},"next_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/event/{event}/shift/link/{link}/shift?per_page=5&_locale=en-US&page=2"]},"path":{"type":"string","examples":["https://example.rosterfy.com/api/v2/event/{event}/shift/link/{link}/shift"]},"per_page":{"type":"integer","examples":[5]},"prev_page_url":{"type":["string","null"],"examples":[null]},"to":{"type":"integer","examples":[5]}}},"examples":[[{"current_page":1,"data":[{"object":{"id":2001,"event_id":1001,"event_shift_type_id":null,"event_shift_template_id":null,"journey_id":null,"min_demand":10,"max_demand":10,"leader_demand":1,"start_timestamp":"2026-09-17 05:00:00","end_timestamp":"2026-09-17 13:00:00","timezone":"Australia/Melbourne","no_shift_time":0,"apps_open_timestamp":null,"apps_close_timestamp":null,"headcount_location_venue_id":null,"shift_confirmed_status_default":3,"shift_rejected_status_default":6,"journey_complete_status":null,"shift_can_withdraw_default":1,"shift_can_confirm":1,"shift_can_confirm_limit":0,"shift_can_withdraw_limit":0,"shift_checked_in_status_default":4,"shift_checked_out_status_default":4,"certificate_id":null,"shift_application_form_id":null,"allow_application_form_resubmit":0,"shift_checkin_form_id":null,"shift_attended_form_id":null,"shift_checkout_form_id":null,"shift_precheckin_form_id":null,"shift_withdraw_form_id":null,"training_ids":null,"visibility_show_groups":[],"visibility_hide_groups":[],"visibility_show_roleoffer":[],"role_offer_id":null,"role_offer_address":0,"checkin_visible_attributes":[],"shift_enable_waitlist_default":0,"max_waitlist":0,"group_booking_ttl":null,"max_group_demand":null,"max_group_size":null,"reserved_expiry":null,"minimum_dob":null,"minimum_age":null,"maximum_dob":null,"maximum_age":null,"self_checkin":0,"self_checkin_open":1800,"self_checkin_close":1800,"self_checkout_close":1800,"checkin_close":0,"shift_precheckin_open":0,"break":0,"post_feedback_form":null,"shift_leader_feedback_form_id":null,"is_virtual":0,"geofence_checkin_limit":null,"tax":null,"price_excluding_tax":0,"tax_percentage":null,"publish":0,"public":0,"sort_order":0,"is_cancelled":0,"deleted_at":null,"is_erased":0,"is_draft":false,"created_at":"2026-06-09T05:36:10.000000Z","updated_at":"2026-06-09T05:36:10.000000Z","deleted_by":null,"address":{"iso":"AUS","region_code":"VIC","coordinates":{"latitude":"-37.814000","longitude":"144.963100"},"street_address_1":"1 Example Street","street_address_2":null,"street_address_3":null,"city":"Melbourne","postcode":"3000","region":"VIC","country":"AU","latitude":"-37.814000","longitude":"144.963100"}},"nice":{"rrn":"rrn:example:20000:shift:2001","address":"1 Example Street\nMelbourne\nVictoria\nAustralia\n3000","address_oneline":"1 Example Street, Melbourne, Victoria, Australia, 3000","address.country":"Australia","address.country:raw":"AUS","address.city":"Melbourne","address.region":"Victoria","address.region:raw":"VIC","address.postcode":"3000","address.street_address_1":"1 Example Street","address.street_address_2":"","address.street_address_3":"","address.latitude":"-37.814000","address.longitude":"144.963100","created_at":"Jun 9, 2026, 3:36 PM","created_at__date":"Jun 9, 2026","created_at__time":"3:36 PM","created_at__offset":" (+10:00 AEST)","created_at__offset_minutes":600,"created_at__dayofweek":"Tuesday","end_timestamp":"Sep 17, 2026, 11:00 PM","end_timestamp__date":"Sep 17, 2026","end_timestamp__time":"11:00 PM","end_timestamp__offset":" (+10:00 AEST)","end_timestamp__offset_minutes":600,"end_timestamp__dayofweek":"Thursday","event_shift_template_id":null,"event_shift_template_id:value":null,"event_shift_template_id:array":null,"event_shift_type_id":null,"event_shift_type_id:value":null,"event_shift_type_id:array":null,"headcount_location_venue_id":null,"headcount_location_venue_id:value":null,"headcount_location_venue_id:array":null,"is_virtual":"No","minimum_age":"","name":"","no_shift_time":"No","post_feedback_form":null,"post_feedback_form:value":null,"post_feedback_form:array":null,"public":"No","publish":"No","role_offer_address":"No","role_offer_id":null,"role_offer_id:value":null,"role_offer_id:array":null,"self_checkin":"No","shift_application_form_id":null,"shift_application_form_id:value":null,"shift_application_form_id:array":null,"shift_attended_form_id":null,"shift_attended_form_id:value":null,"shift_attended_form_id:array":null,"shift_checkin_form_id":null,"shift_checkin_form_id:value":null,"shift_checkin_form_id:array":null,"shift_checkout_form_id":null,"shift_checkout_form_id:value":null,"shift_checkout_form_id:array":null,"shift_precheckin_form_id":null,"shift_precheckin_form_id:value":null,"shift_precheckin_form_id:array":null,"shift_withdraw_form_id":null,"shift_withdraw_form_id:value":null,"shift_withdraw_form_id:array":null,"start_timestamp":"Sep 17, 2026, 3:00 PM","start_timestamp__date":"Sep 17, 2026","start_timestamp__time":"3:00 PM","start_timestamp__offset":" (+10:00 AEST)","start_timestamp__offset_minutes":600,"start_timestamp__dayofweek":"Thursday","updated_at":"Jun 9, 2026, 3:36 PM","updated_at__date":"Jun 9, 2026","updated_at__time":"3:36 PM","updated_at__offset":" (+10:00 AEST)","updated_at__offset_minutes":600,"updated_at__dayofweek":"Tuesday","visibility_hide_groups":"","visibility_show_groups":"","visibility_show_roleoffer":"","info":" - ","event_shift_link_id":1,"event_shift_link_repeat":1,"event_shift_link_name":"test shift link","shift_status_default_id":1,"length":8,"account_id":20000,"account_url":"https://example.rosterfy.com/","is_any_leader":false,"post_shift_feedback_form_completed_at":"","pre_checkin_form_completed_at":"","event_name":null},"relations":{"pivot":{"event_shift_link_id":3001,"event_shift_id":2001}},"permissions":{"read":true,"update":true,"delete":true,"apply":false,"apply_error":"Shift applications not open","apply_error_code":"ES0056","is_unavailable":false,"confirm":false,"reject":false,"selfCheckin":false,"selfCheckout":false,"submitAttendedForm":false,"precheckin":false,"applyWaitlist":false},"attributes":[]},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}],"first_page_url":"https://example.rosterfy.com/api/v2/event/{event}/shift/link/{link}/shift?per_page=5&_locale=en-US&page=1","from":1,"next_page_url":"https://example.rosterfy.com/api/v2/event/{event}/shift/link/{link}/shift?per_page=5&_locale=en-US&page=2","path":"https://example.rosterfy.com/api/v2/event/{event}/shift/link/{link}/shift","per_page":5,"prev_page_url":null,"to":5}]]},"id":"schema_439"},"schema_440":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[3001]},"event_id":{"type":"integer","examples":[1001]},"event_shift_pattern_id":{"type":["string","null"],"examples":[null]},"name":{"type":"string","examples":["Saturday gate crew"]},"frontend_name":{"type":"string","examples":["Saturday gate crew"]},"repeat":{"type":"integer","examples":[1]},"end_date":{"type":["string","null"],"examples":[null]},"rules":{"type":"object","properties":{"days":{"type":"array","items":{"type":"integer"},"examples":[[1,2,3,4,5,6,0]]}}},"created_at":{"type":"string","examples":["2026-06-09T05:36:10.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:10.000000Z"]}}},"nice":{"type":"array","examples":[[]]},"relations":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]}}}},"examples":[{"object":{"id":3001,"event_id":1001,"event_shift_pattern_id":null,"name":"Saturday gate crew","frontend_name":"Saturday gate crew","repeat":1,"end_date":null,"rules":{"days":[1,2,3,4,5,6,0]},"created_at":"2026-06-09T05:36:10.000000Z","updated_at":"2026-06-09T05:36:10.000000Z"},"nice":[],"relations":[],"permissions":{"read":true,"update":true,"delete":true}}]},"id":"schema_440"},"schema_441":{"kind":"json-schema","data":{"type":"object","properties":{"name":{"type":"string","description":"The name of the series, as it reads to your team. Up to 255 characters, and it may not be emptied.","examples":[null]},"frontend_name":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name of the series as volunteers see it, keyed by locale code - for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{\"en-US\": \"Saturday gate crew\"}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Only the locales you send are replaced; any others already stored are kept. A plain string is also accepted and is filed under the locale the request is being read in."},"children":[]}]}]}],"properties":{},"examples":["{}"]}}},"id":"schema_441"},"schema_442":{"kind":"json-schema","data":{"type":"object","properties":{"cartItems":{"type":"array","description":"The shifts already in the cart, so they are taken into account when checking whether this one can be added. Unpublished shifts and shifts outside the account are dropped from the list. The name is camelCase because that is what the endpoint reads.","items":{"type":"integer"},"examples":[[]]},"asLeader":{"type":"boolean","description":"Check whether the person can take this shift as its leader rather than as an ordinary place. The name is camelCase because that is what the endpoint reads.","examples":[true]}}},"id":"schema_442"},"schema_443":{"kind":"json-schema","data":{"type":"object","properties":{"queue":{"type":"string","examples":["qRVHdJcK2U9ZFMVUBEdqsdVt"]}},"examples":[{"queue":"qRVHdJcK2U9ZFMVUBEdqsdVt"}]},"id":"schema_443"},"schema_444":{"kind":"json-schema","data":{"type":"object","properties":{"name":{"type":"string","description":"What the shift is called. Shown to people choosing shifts.","examples":[null]},"timezone":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The timezone the start and end times are given in, as an IANA name such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Australia/Melbourne"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"min_demand":{"type":"integer","description":"The fewest people the shift needs. Defaults to 1.","examples":[1]},"max_demand":{"type":"integer","description":"The most people the shift can take. Applications are refused once it is full.","examples":[1]},"leader_demand":{"type":"integer","description":"How many of those places are for leaders. Defaults to 0.","examples":[1]},"start_timestamp":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the shift starts, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD HH:MM:SS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the shift's timezone."},"children":[]}]}]}],"examples":[null]},"end_timestamp":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the shift ends, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD HH:MM:SS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the shift's timezone."},"children":[]}]}]}],"examples":[null]},"is_virtual":{"type":"boolean","description":"Whether the shift happens online rather than at a place.","examples":[true]},"event_shift_type_id":{"type":"integer","description":"The shift type, which groups shifts for reporting and for the per-type application limits an event can set.","examples":[1]},"shift_status_default":{"type":"integer","description":"The status a new application on this shift starts at.","examples":[1]},"shift_confirmed_status_default":{"type":"integer","description":"The status an application moves to when it is confirmed.","examples":[1]},"shift_rejected_status_default":{"type":"integer","description":"The status an application moves to when it is rejected.","examples":[1]},"shift_can_withdraw_default":{"type":"boolean","description":"Whether people can withdraw from the shift themselves.","examples":[true]},"shift_can_withdraw_limit":{"type":"integer","description":"How long before the shift starts withdrawing stops being allowed, in seconds.","examples":[1]},"shift_can_confirm":{"type":"boolean","description":"Whether people can confirm their own place on the shift.","examples":[true]},"shift_can_confirm_limit":{"type":"integer","description":"How long before the shift starts confirming stops being allowed, in seconds.","examples":[1]},"shift_checked_in_status_default":{"type":"integer","description":"The status an assignment moves to on check-in.","examples":[1]},"shift_checked_out_status_default":{"type":"integer","description":"The status an assignment moves to on check-out.","examples":[1]},"address":{"type":"object","description":"Where the shift happens, as an address object. Required on a create unless the shift is virtual or takes its location from a venue.","properties":{"street_address_1":{"type":"string","description":"","examples":[null]},"street_address_2":{"type":"string","description":"","examples":[null]},"street_address_3":{"type":"string","description":"","examples":[null]},"city":{"type":"string","description":"","examples":[null]},"postcode":{"type":"string","description":"","examples":[null]},"region":{"type":"string","description":"","examples":[null]},"country":{"type":"string","description":"","examples":[null]},"latitude":{"type":"string","description":"","examples":[null]},"longitude":{"type":"string","description":"","examples":[null]}},"examples":["{}"]},"headcount_location_venue_id":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The venue the shift happens at. Sending one takes the location from the venue instead of from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"address"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[1]},"certificate_id":{"type":"integer","description":"A certificate awarded for attending the shift.","examples":[1]},"shift_application_form_id":{"type":"integer","description":"The form someone fills in when applying for this shift.","examples":[1]},"allow_application_form_resubmit":{"type":"boolean","description":"Whether someone can submit the application form again.","examples":[true]},"shift_precheckin_form_id":{"type":"integer","description":"The form filled in at pre-check-in.","examples":[1]},"shift_checkin_form_id":{"type":"integer","description":"The form filled in at check-in.","examples":[1]},"shift_attended_form_id":{"type":"integer","description":"The form filled in once the shift has been attended.","examples":[1]},"shift_checkout_form_id":{"type":"integer","description":"The form filled in at check-out.","examples":[1]},"shift_withdraw_form_id":{"type":"integer","description":"The form filled in when withdrawing.","examples":[1]},"visibility_show_groups":{"type":"array","description":"Only members of these groups can see the shift.","items":{"type":"integer"},"examples":[[]]},"visibility_hide_groups":{"type":"array","description":"Members of these groups cannot see the shift.","items":{"type":"integer"},"examples":[[]]},"visibility_show_roleoffer":{"type":"array","description":"Only people holding one of these role offers can see the shift.","items":{"type":"integer"},"examples":[[]]},"apps_open_timestamp":{"type":"string","description":"When applications open. Before this, applying is refused.","examples":[null]},"apps_close_timestamp":{"type":"string","description":"When applications close. After this, applying is refused.","examples":[null]},"role_offer_id":{"type":"integer","description":"The role offer this shift belongs to.","examples":[1]},"role_offer_address":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Take the shift's location from the role offer rather than from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"address"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[true]},"shift_precheckin_open":{"type":"integer","description":"How long before the shift starts pre-check-in opens, in seconds.","examples":[1]},"max_group_demand":{"type":"integer","description":"How many places a single group booking can take.","examples":[1]},"group_booking_ttl":{"type":"integer","description":"How long a group booking is held before it lapses, in seconds.","examples":[1]},"max_group_size":{"type":"integer","description":"The largest group that can book onto the shift.","examples":[1]},"reserved_expiry":{"type":"integer","description":"How long a reserved place is held before it lapses, in seconds.","examples":[1]},"self_checkin":{"type":"boolean","description":"Whether people can check themselves in to the shift.","examples":[true]},"self_checkin_open":{"type":"integer","description":"How long before the shift starts self check-in opens, in seconds.","examples":[1]},"self_checkin_close":{"type":"integer","description":"How long after the shift starts self check-in closes, in seconds.","examples":[1]},"self_checkout_close":{"type":"integer","description":"How long after the shift ends self check-out closes, in seconds.","examples":[1]},"checkin_close":{"type":"integer","description":"How long after the shift ends check-in closes, in seconds.","examples":[1]},"geofence_checkin_limit":{"type":"integer","description":"How close to the shift's location someone has to be to check in, in metres.","examples":[1]},"checkin_visible_attributes":{"type":"array","description":"Which of a person's attributes are shown on the check-in screen.","items":{"type":"integer"},"examples":[[]]},"training_ids":{"type":"array","description":"Training people must have completed before they can be placed on the shift.","items":{"type":"integer"},"examples":[[]]},"post_feedback_form":{"type":"integer","description":"The form people fill in about the shift afterwards.","examples":[1]},"shift_leader_feedback_form_id":{"type":"integer","description":"The form a leader fills in about the shift.","examples":[1]},"shift_enable_waitlist_default":{"type":"boolean","description":"Whether people can join a waitlist once the shift is full.","examples":[true]},"max_waitlist":{"type":"integer","description":"How many people the waitlist holds.","examples":[1]},"publish":{"type":"boolean","description":"Whether the shift is visible to people who can apply for it. Ignored from a caller who cannot publish shifts.","examples":[true]},"public":{"type":"boolean","description":"Whether the shift can be seen without signing in, on a public event.","examples":[true]},"is_cancelled":{"type":"boolean","description":"Whether the shift is cancelled. Cancelling this way does not move anyone already on the shift; use the cancel endpoint for that.","examples":[true]},"sort_order":{"type":"integer","description":"Where the shift sits when shifts are shown in a fixed order.","examples":[1]},"minimum_dob":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Latest date of birth allowed on the shift. Cannot be sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"minimum_age"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"minimum_age":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Youngest age allowed on the shift, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"years:months"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"maximum_dob":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Earliest date of birth allowed on the shift. Cannot be sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"maximum_age"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"maximum_age":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Oldest age allowed on the shift, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"years:months"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"price_excluding_tax":{"type":"number","description":"What taking this shift costs the person, before tax.","examples":[1.23]},"tax_percentage":{"type":"integer","description":"Tax charged on the price, as a percentage between 0 and 100.","examples":[1]},"cost_description":{"type":"string","description":"Free text shown alongside the price.","examples":[null]},"applyTo":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to act only on the shifts named in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Any other value acts on every shift the caller can see, narrowed by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filter"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if one is sent, and narrowed to the event in the URL. Required, but the value is not checked against a list, so a typo is accepted and treated as \"everything\"."},"children":[]}]}]}],"examples":[null]},"selected":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The IDs of the shifts to update. Required in practice when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"applyTo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", but nothing validates that: omitting it still returns a queue token and the background work then does nothing."},"children":[]}]}]}],"items":{"type":"integer"},"examples":[[]]},"filter":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The same filter object the listing takes, used to choose the shifts to act on when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"applyTo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"properties":{},"examples":["{}"]},"custom_*":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A custom attribute, named by its code - custom_shirt_size, for example. The value follows the attribute's own type, so it may be a string, a number, a boolean or a list. See the custom attributes documentation."},"children":[]}]}]}],"examples":[null]}},"required":["applyTo"]},"id":"schema_444"},"schema_445":{"kind":"json-schema","data":{"type":"object","properties":{"queue":{"type":"string","examples":["vqWN9bLNDXJKR4jSnf5efYTc"]}},"examples":[{"queue":"vqWN9bLNDXJKR4jSnf5efYTc"}]},"id":"schema_445"},"schema_446":{"kind":"json-schema","data":{"type":"boolean","description":"Keep only shifts the signed-in person has applied for.","examples":[true]},"id":"schema_446"},"schema_447":{"kind":"json-schema","data":{"type":"boolean","description":"Keep only shifts the signed-in person holds a place on.","examples":[true]},"id":"schema_447"},"schema_448":{"kind":"json-schema","data":{"type":"boolean","description":"Keep only shifts the signed-in person leads.","examples":[true]},"id":"schema_448"},"schema_449":{"kind":"json-schema","data":{"type":"boolean","description":"Keep only shifts the signed-in person is not already\non. Named in camelCase because that is what the endpoint reads.","examples":[true]},"id":"schema_449"},"schema_450":{"kind":"json-schema","data":{"type":"boolean","description":"Keep only shifts that do not belong to a linked\nseries. Named in camelCase because that is what the endpoint reads.","examples":[true]},"id":"schema_450"},"schema_451":{"kind":"json-schema","data":{"type":"boolean","description":"Keep only shifts on events the signed-in person has\nregistered interest in. Named in camelCase because that is what the endpoint reads.","examples":[true]},"id":"schema_451"},"schema_452":{"kind":"json-schema","data":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Work out each shift's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"permissions.apply"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" as though"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the person were swapping out of a shift they already hold, rather than taking an"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"extra one. Named in camelCase because that is what the endpoint reads."},"children":[]}]}]}],"examples":[true]},"id":"schema_452"},"schema_453":{"kind":"json-schema","data":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The shift being swapped out of, used with"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"intentToSwap"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Named in camelCase because that is what the endpoint reads."},"children":[]}]}]}],"examples":[2001]},"id":"schema_453"},"schema_454":{"kind":"json-schema","data":{"type":"array","items":{"type":"object","properties":{"current_page":{"type":"integer","examples":[1]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[2001]},"event_id":{"type":"integer","examples":[1001]},"event_shift_type_id":{"type":["string","null"],"examples":[null]},"event_shift_template_id":{"type":["string","null"],"examples":[null]},"journey_id":{"type":["string","null"],"examples":[null]},"min_demand":{"type":"integer","examples":[10]},"max_demand":{"type":"integer","examples":[10]},"leader_demand":{"type":"integer","examples":[1]},"start_timestamp":{"type":"string","examples":["2026-09-17 05:00:00"]},"end_timestamp":{"type":"string","examples":["2026-09-17 13:00:00"]},"timezone":{"type":"string","examples":["Australia/Melbourne"]},"no_shift_time":{"type":"integer","examples":[0]},"apps_open_timestamp":{"type":["string","null"],"examples":[null]},"apps_close_timestamp":{"type":["string","null"],"examples":[null]},"headcount_location_venue_id":{"type":["string","null"],"examples":[null]},"shift_confirmed_status_default":{"type":"integer","examples":[3]},"shift_rejected_status_default":{"type":"integer","examples":[6]},"journey_complete_status":{"type":["string","null"],"examples":[null]},"shift_can_withdraw_default":{"type":"integer","examples":[1]},"shift_can_confirm":{"type":"integer","examples":[1]},"shift_can_confirm_limit":{"type":"integer","examples":[0]},"shift_can_withdraw_limit":{"type":"integer","examples":[0]},"shift_checked_in_status_default":{"type":"integer","examples":[4]},"shift_checked_out_status_default":{"type":"integer","examples":[4]},"certificate_id":{"type":["string","null"],"examples":[null]},"shift_application_form_id":{"type":["string","null"],"examples":[null]},"allow_application_form_resubmit":{"type":"integer","examples":[0]},"shift_checkin_form_id":{"type":["string","null"],"examples":[null]},"shift_attended_form_id":{"type":["string","null"],"examples":[null]},"shift_checkout_form_id":{"type":["string","null"],"examples":[null]},"shift_precheckin_form_id":{"type":["string","null"],"examples":[null]},"shift_withdraw_form_id":{"type":["string","null"],"examples":[null]},"training_ids":{"type":["string","null"],"examples":[null]},"visibility_show_groups":{"type":"array","examples":[[]]},"visibility_hide_groups":{"type":"array","examples":[[]]},"visibility_show_roleoffer":{"type":"array","examples":[[]]},"role_offer_id":{"type":["string","null"],"examples":[null]},"role_offer_address":{"type":"integer","examples":[0]},"checkin_visible_attributes":{"type":"array","examples":[[]]},"shift_enable_waitlist_default":{"type":"integer","examples":[0]},"max_waitlist":{"type":"integer","examples":[0]},"group_booking_ttl":{"type":["string","null"],"examples":[null]},"max_group_demand":{"type":["string","null"],"examples":[null]},"max_group_size":{"type":["string","null"],"examples":[null]},"reserved_expiry":{"type":["string","null"],"examples":[null]},"minimum_dob":{"type":["string","null"],"examples":[null]},"minimum_age":{"type":["string","null"],"examples":[null]},"maximum_dob":{"type":["string","null"],"examples":[null]},"maximum_age":{"type":["string","null"],"examples":[null]},"self_checkin":{"type":"integer","examples":[0]},"self_checkin_open":{"type":"integer","examples":[1800]},"self_checkin_close":{"type":"integer","examples":[1800]},"self_checkout_close":{"type":"integer","examples":[1800]},"checkin_close":{"type":"integer","examples":[0]},"shift_precheckin_open":{"type":"integer","examples":[0]},"break":{"type":"integer","examples":[0]},"post_feedback_form":{"type":["string","null"],"examples":[null]},"shift_leader_feedback_form_id":{"type":["string","null"],"examples":[null]},"is_virtual":{"type":"integer","examples":[0]},"geofence_checkin_limit":{"type":["string","null"],"examples":[null]},"tax":{"type":["string","null"],"examples":[null]},"price_excluding_tax":{"type":"integer","examples":[0]},"tax_percentage":{"type":["string","null"],"examples":[null]},"publish":{"type":"integer","examples":[0]},"public":{"type":"integer","examples":[0]},"sort_order":{"type":"integer","examples":[0]},"is_cancelled":{"type":"integer","examples":[0]},"deleted_at":{"type":["string","null"],"examples":[null]},"is_erased":{"type":"integer","examples":[0]},"is_draft":{"type":"boolean","examples":[false]},"created_at":{"type":"string","examples":["2026-06-09T05:36:10.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:10.000000Z"]},"deleted_by":{"type":["string","null"],"examples":[null]},"address":{"type":"object","properties":{"iso":{"type":"string","examples":["AUS"]},"region_code":{"type":"string","examples":["VIC"]},"coordinates":{"type":"object","properties":{"latitude":{"type":"string","examples":["-37.814000"]},"longitude":{"type":"string","examples":["144.963100"]}}},"street_address_1":{"type":"string","examples":["1 Example Street"]},"street_address_2":{"type":["string","null"],"examples":[null]},"street_address_3":{"type":["string","null"],"examples":[null]},"city":{"type":"string","examples":["Melbourne"]},"postcode":{"type":"string","examples":["3000"]},"region":{"type":"string","examples":["VIC"]},"country":{"type":"string","examples":["AU"]},"latitude":{"type":"string","examples":["-37.814000"]},"longitude":{"type":"string","examples":["144.963100"]}}}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:example:20000:shift:2001"]},"address":{"type":"string","examples":["1 Example Street\nMelbourne\nVictoria\nAustralia\n3000"]},"address_oneline":{"type":"string","examples":["1 Example Street, Melbourne, Victoria, Australia, 3000"]},"address.country":{"type":"string","examples":["Australia"]},"address.country:raw":{"type":"string","examples":["AUS"]},"address.city":{"type":"string","examples":["Melbourne"]},"address.region":{"type":"string","examples":["Victoria"]},"address.region:raw":{"type":"string","examples":["VIC"]},"address.postcode":{"type":"string","examples":["3000"]},"address.street_address_1":{"type":"string","examples":["1 Example Street"]},"address.street_address_2":{"type":"string","examples":[""]},"address.street_address_3":{"type":"string","examples":[""]},"address.latitude":{"type":"string","examples":["-37.814000"]},"address.longitude":{"type":"string","examples":["144.963100"]},"created_at":{"type":"string","examples":["Jun 9, 2026, 3:36 PM"]},"created_at__date":{"type":"string","examples":["Jun 9, 2026"]},"created_at__time":{"type":"string","examples":["3:36 PM"]},"created_at__offset":{"type":"string","examples":[" (+10:00 AEST)"]},"created_at__offset_minutes":{"type":"integer","examples":[600]},"created_at__dayofweek":{"type":"string","examples":["Tuesday"]},"end_timestamp":{"type":"string","examples":["Sep 17, 2026, 11:00 PM"]},"end_timestamp__date":{"type":"string","examples":["Sep 17, 2026"]},"end_timestamp__time":{"type":"string","examples":["11:00 PM"]},"end_timestamp__offset":{"type":"string","examples":[" (+10:00 AEST)"]},"end_timestamp__offset_minutes":{"type":"integer","examples":[600]},"end_timestamp__dayofweek":{"type":"string","examples":["Thursday"]},"event_shift_template_id":{"type":["string","null"],"examples":[null]},"event_shift_template_id:value":{"type":["string","null"],"examples":[null]},"event_shift_template_id:array":{"type":["string","null"],"examples":[null]},"event_shift_type_id":{"type":["string","null"],"examples":[null]},"event_shift_type_id:value":{"type":["string","null"],"examples":[null]},"event_shift_type_id:array":{"type":["string","null"],"examples":[null]},"headcount_location_venue_id":{"type":["string","null"],"examples":[null]},"headcount_location_venue_id:value":{"type":["string","null"],"examples":[null]},"headcount_location_venue_id:array":{"type":["string","null"],"examples":[null]},"is_virtual":{"type":"string","examples":["No"]},"minimum_age":{"type":"string","examples":[""]},"name":{"type":"string","examples":[""]},"no_shift_time":{"type":"string","examples":["No"]},"post_feedback_form":{"type":["string","null"],"examples":[null]},"post_feedback_form:value":{"type":["string","null"],"examples":[null]},"post_feedback_form:array":{"type":["string","null"],"examples":[null]},"public":{"type":"string","examples":["No"]},"publish":{"type":"string","examples":["No"]},"role_offer_address":{"type":"string","examples":["No"]},"role_offer_id":{"type":["string","null"],"examples":[null]},"role_offer_id:value":{"type":["string","null"],"examples":[null]},"role_offer_id:array":{"type":["string","null"],"examples":[null]},"self_checkin":{"type":"string","examples":["No"]},"shift_application_form_id":{"type":["string","null"],"examples":[null]},"shift_application_form_id:value":{"type":["string","null"],"examples":[null]},"shift_application_form_id:array":{"type":["string","null"],"examples":[null]},"shift_attended_form_id":{"type":["string","null"],"examples":[null]},"shift_attended_form_id:value":{"type":["string","null"],"examples":[null]},"shift_attended_form_id:array":{"type":["string","null"],"examples":[null]},"shift_checkin_form_id":{"type":["string","null"],"examples":[null]},"shift_checkin_form_id:value":{"type":["string","null"],"examples":[null]},"shift_checkin_form_id:array":{"type":["string","null"],"examples":[null]},"shift_checkout_form_id":{"type":["string","null"],"examples":[null]},"shift_checkout_form_id:value":{"type":["string","null"],"examples":[null]},"shift_checkout_form_id:array":{"type":["string","null"],"examples":[null]},"shift_precheckin_form_id":{"type":["string","null"],"examples":[null]},"shift_precheckin_form_id:value":{"type":["string","null"],"examples":[null]},"shift_precheckin_form_id:array":{"type":["string","null"],"examples":[null]},"shift_withdraw_form_id":{"type":["string","null"],"examples":[null]},"shift_withdraw_form_id:value":{"type":["string","null"],"examples":[null]},"shift_withdraw_form_id:array":{"type":["string","null"],"examples":[null]},"start_timestamp":{"type":"string","examples":["Sep 17, 2026, 3:00 PM"]},"start_timestamp__date":{"type":"string","examples":["Sep 17, 2026"]},"start_timestamp__time":{"type":"string","examples":["3:00 PM"]},"start_timestamp__offset":{"type":"string","examples":[" (+10:00 AEST)"]},"start_timestamp__offset_minutes":{"type":"integer","examples":[600]},"start_timestamp__dayofweek":{"type":"string","examples":["Thursday"]},"updated_at":{"type":"string","examples":["Jun 9, 2026, 3:36 PM"]},"updated_at__date":{"type":"string","examples":["Jun 9, 2026"]},"updated_at__time":{"type":"string","examples":["3:36 PM"]},"updated_at__offset":{"type":"string","examples":[" (+10:00 AEST)"]},"updated_at__offset_minutes":{"type":"integer","examples":[600]},"updated_at__dayofweek":{"type":"string","examples":["Tuesday"]},"visibility_hide_groups":{"type":"string","examples":[""]},"visibility_show_groups":{"type":"string","examples":[""]},"visibility_show_roleoffer":{"type":"string","examples":[""]},"info":{"type":"string","examples":[" - "]},"event_shift_link_id":{"type":"integer","examples":[1]},"event_shift_link_repeat":{"type":"integer","examples":[1]},"event_shift_link_name":{"type":"string","examples":["test shift link"]},"shift_status_default_id":{"type":"integer","examples":[1]},"length":{"type":"integer","examples":[8]},"account_id":{"type":"integer","examples":[20000]},"account_url":{"type":"string","examples":["https://example.rosterfy.com/"]},"is_any_leader":{"type":"boolean","examples":[false]},"post_shift_feedback_form_completed_at":{"type":"string","examples":[""]},"pre_checkin_form_completed_at":{"type":"string","examples":[""]},"event_name":{"type":["string","null"],"examples":[null]}}},"relations":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]},"apply":{"type":"boolean","examples":[false]},"apply_error":{"type":"string","examples":["Shift applications not open"]},"apply_error_code":{"type":"string","examples":["ES0056"]},"is_unavailable":{"type":"boolean","examples":[false]},"confirm":{"type":"boolean","examples":[false]},"reject":{"type":"boolean","examples":[false]},"selfCheckin":{"type":"boolean","examples":[false]},"selfCheckout":{"type":"boolean","examples":[false]},"submitAttendedForm":{"type":"boolean","examples":[false]},"precheckin":{"type":"boolean","examples":[false]},"applyWaitlist":{"type":"boolean","examples":[false]}}},"attributes":{"type":"array","examples":[[]]}}},"examples":[[{"object":{"id":2001,"event_id":1001,"event_shift_type_id":null,"event_shift_template_id":null,"journey_id":null,"min_demand":10,"max_demand":10,"leader_demand":1,"start_timestamp":"2026-09-17 05:00:00","end_timestamp":"2026-09-17 13:00:00","timezone":"Australia/Melbourne","no_shift_time":0,"apps_open_timestamp":null,"apps_close_timestamp":null,"headcount_location_venue_id":null,"shift_confirmed_status_default":3,"shift_rejected_status_default":6,"journey_complete_status":null,"shift_can_withdraw_default":1,"shift_can_confirm":1,"shift_can_confirm_limit":0,"shift_can_withdraw_limit":0,"shift_checked_in_status_default":4,"shift_checked_out_status_default":4,"certificate_id":null,"shift_application_form_id":null,"allow_application_form_resubmit":0,"shift_checkin_form_id":null,"shift_attended_form_id":null,"shift_checkout_form_id":null,"shift_precheckin_form_id":null,"shift_withdraw_form_id":null,"training_ids":null,"visibility_show_groups":[],"visibility_hide_groups":[],"visibility_show_roleoffer":[],"role_offer_id":null,"role_offer_address":0,"checkin_visible_attributes":[],"shift_enable_waitlist_default":0,"max_waitlist":0,"group_booking_ttl":null,"max_group_demand":null,"max_group_size":null,"reserved_expiry":null,"minimum_dob":null,"minimum_age":null,"maximum_dob":null,"maximum_age":null,"self_checkin":0,"self_checkin_open":1800,"self_checkin_close":1800,"self_checkout_close":1800,"checkin_close":0,"shift_precheckin_open":0,"break":0,"post_feedback_form":null,"shift_leader_feedback_form_id":null,"is_virtual":0,"geofence_checkin_limit":null,"tax":null,"price_excluding_tax":0,"tax_percentage":null,"publish":0,"public":0,"sort_order":0,"is_cancelled":0,"deleted_at":null,"is_erased":0,"is_draft":false,"created_at":"2026-06-09T05:36:10.000000Z","updated_at":"2026-06-09T05:36:10.000000Z","deleted_by":null,"address":{"iso":"AUS","region_code":"VIC","coordinates":{"latitude":"-37.814000","longitude":"144.963100"},"street_address_1":"1 Example Street","street_address_2":null,"street_address_3":null,"city":"Melbourne","postcode":"3000","region":"VIC","country":"AU","latitude":"-37.814000","longitude":"144.963100"}},"nice":{"rrn":"rrn:example:20000:shift:2001","address":"1 Example Street\nMelbourne\nVictoria\nAustralia\n3000","address_oneline":"1 Example Street, Melbourne, Victoria, Australia, 3000","address.country":"Australia","address.country:raw":"AUS","address.city":"Melbourne","address.region":"Victoria","address.region:raw":"VIC","address.postcode":"3000","address.street_address_1":"1 Example Street","address.street_address_2":"","address.street_address_3":"","address.latitude":"-37.814000","address.longitude":"144.963100","created_at":"Jun 9, 2026, 3:36 PM","created_at__date":"Jun 9, 2026","created_at__time":"3:36 PM","created_at__offset":" (+10:00 AEST)","created_at__offset_minutes":600,"created_at__dayofweek":"Tuesday","end_timestamp":"Sep 17, 2026, 11:00 PM","end_timestamp__date":"Sep 17, 2026","end_timestamp__time":"11:00 PM","end_timestamp__offset":" (+10:00 AEST)","end_timestamp__offset_minutes":600,"end_timestamp__dayofweek":"Thursday","event_shift_template_id":null,"event_shift_template_id:value":null,"event_shift_template_id:array":null,"event_shift_type_id":null,"event_shift_type_id:value":null,"event_shift_type_id:array":null,"headcount_location_venue_id":null,"headcount_location_venue_id:value":null,"headcount_location_venue_id:array":null,"is_virtual":"No","minimum_age":"","name":"","no_shift_time":"No","post_feedback_form":null,"post_feedback_form:value":null,"post_feedback_form:array":null,"public":"No","publish":"No","role_offer_address":"No","role_offer_id":null,"role_offer_id:value":null,"role_offer_id:array":null,"self_checkin":"No","shift_application_form_id":null,"shift_application_form_id:value":null,"shift_application_form_id:array":null,"shift_attended_form_id":null,"shift_attended_form_id:value":null,"shift_attended_form_id:array":null,"shift_checkin_form_id":null,"shift_checkin_form_id:value":null,"shift_checkin_form_id:array":null,"shift_checkout_form_id":null,"shift_checkout_form_id:value":null,"shift_checkout_form_id:array":null,"shift_precheckin_form_id":null,"shift_precheckin_form_id:value":null,"shift_precheckin_form_id:array":null,"shift_withdraw_form_id":null,"shift_withdraw_form_id:value":null,"shift_withdraw_form_id:array":null,"start_timestamp":"Sep 17, 2026, 3:00 PM","start_timestamp__date":"Sep 17, 2026","start_timestamp__time":"3:00 PM","start_timestamp__offset":" (+10:00 AEST)","start_timestamp__offset_minutes":600,"start_timestamp__dayofweek":"Thursday","updated_at":"Jun 9, 2026, 3:36 PM","updated_at__date":"Jun 9, 2026","updated_at__time":"3:36 PM","updated_at__offset":" (+10:00 AEST)","updated_at__offset_minutes":600,"updated_at__dayofweek":"Tuesday","visibility_hide_groups":"","visibility_show_groups":"","visibility_show_roleoffer":"","info":" - ","event_shift_link_id":1,"event_shift_link_repeat":1,"event_shift_link_name":"test shift link","shift_status_default_id":1,"length":8,"account_id":20000,"account_url":"https://example.rosterfy.com/","is_any_leader":false,"post_shift_feedback_form_completed_at":"","pre_checkin_form_completed_at":"","event_name":null},"relations":[],"permissions":{"read":true,"update":true,"delete":true,"apply":false,"apply_error":"Shift applications not open","apply_error_code":"ES0056","is_unavailable":false,"confirm":false,"reject":false,"selfCheckin":false,"selfCheckout":false,"submitAttendedForm":false,"precheckin":false,"applyWaitlist":false},"attributes":[]},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}]]},"first_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/event/{event}/shift?per_page=5&_locale=en-US&page=1"]},"from":{"type":"integer","examples":[1]},"next_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/event/{event}/shift?per_page=5&_locale=en-US&page=2"]},"path":{"type":"string","examples":["https://example.rosterfy.com/api/v2/event/{event}/shift"]},"per_page":{"type":"integer","examples":[5]},"prev_page_url":{"type":["string","null"],"examples":[null]},"to":{"type":"integer","examples":[5]}}},"examples":[[{"current_page":1,"data":[{"object":{"id":2001,"event_id":1001,"event_shift_type_id":null,"event_shift_template_id":null,"journey_id":null,"min_demand":10,"max_demand":10,"leader_demand":1,"start_timestamp":"2026-09-17 05:00:00","end_timestamp":"2026-09-17 13:00:00","timezone":"Australia/Melbourne","no_shift_time":0,"apps_open_timestamp":null,"apps_close_timestamp":null,"headcount_location_venue_id":null,"shift_confirmed_status_default":3,"shift_rejected_status_default":6,"journey_complete_status":null,"shift_can_withdraw_default":1,"shift_can_confirm":1,"shift_can_confirm_limit":0,"shift_can_withdraw_limit":0,"shift_checked_in_status_default":4,"shift_checked_out_status_default":4,"certificate_id":null,"shift_application_form_id":null,"allow_application_form_resubmit":0,"shift_checkin_form_id":null,"shift_attended_form_id":null,"shift_checkout_form_id":null,"shift_precheckin_form_id":null,"shift_withdraw_form_id":null,"training_ids":null,"visibility_show_groups":[],"visibility_hide_groups":[],"visibility_show_roleoffer":[],"role_offer_id":null,"role_offer_address":0,"checkin_visible_attributes":[],"shift_enable_waitlist_default":0,"max_waitlist":0,"group_booking_ttl":null,"max_group_demand":null,"max_group_size":null,"reserved_expiry":null,"minimum_dob":null,"minimum_age":null,"maximum_dob":null,"maximum_age":null,"self_checkin":0,"self_checkin_open":1800,"self_checkin_close":1800,"self_checkout_close":1800,"checkin_close":0,"shift_precheckin_open":0,"break":0,"post_feedback_form":null,"shift_leader_feedback_form_id":null,"is_virtual":0,"geofence_checkin_limit":null,"tax":null,"price_excluding_tax":0,"tax_percentage":null,"publish":0,"public":0,"sort_order":0,"is_cancelled":0,"deleted_at":null,"is_erased":0,"is_draft":false,"created_at":"2026-06-09T05:36:10.000000Z","updated_at":"2026-06-09T05:36:10.000000Z","deleted_by":null,"address":{"iso":"AUS","region_code":"VIC","coordinates":{"latitude":"-37.814000","longitude":"144.963100"},"street_address_1":"1 Example Street","street_address_2":null,"street_address_3":null,"city":"Melbourne","postcode":"3000","region":"VIC","country":"AU","latitude":"-37.814000","longitude":"144.963100"}},"nice":{"rrn":"rrn:example:20000:shift:2001","address":"1 Example Street\nMelbourne\nVictoria\nAustralia\n3000","address_oneline":"1 Example Street, Melbourne, Victoria, Australia, 3000","address.country":"Australia","address.country:raw":"AUS","address.city":"Melbourne","address.region":"Victoria","address.region:raw":"VIC","address.postcode":"3000","address.street_address_1":"1 Example Street","address.street_address_2":"","address.street_address_3":"","address.latitude":"-37.814000","address.longitude":"144.963100","created_at":"Jun 9, 2026, 3:36 PM","created_at__date":"Jun 9, 2026","created_at__time":"3:36 PM","created_at__offset":" (+10:00 AEST)","created_at__offset_minutes":600,"created_at__dayofweek":"Tuesday","end_timestamp":"Sep 17, 2026, 11:00 PM","end_timestamp__date":"Sep 17, 2026","end_timestamp__time":"11:00 PM","end_timestamp__offset":" (+10:00 AEST)","end_timestamp__offset_minutes":600,"end_timestamp__dayofweek":"Thursday","event_shift_template_id":null,"event_shift_template_id:value":null,"event_shift_template_id:array":null,"event_shift_type_id":null,"event_shift_type_id:value":null,"event_shift_type_id:array":null,"headcount_location_venue_id":null,"headcount_location_venue_id:value":null,"headcount_location_venue_id:array":null,"is_virtual":"No","minimum_age":"","name":"","no_shift_time":"No","post_feedback_form":null,"post_feedback_form:value":null,"post_feedback_form:array":null,"public":"No","publish":"No","role_offer_address":"No","role_offer_id":null,"role_offer_id:value":null,"role_offer_id:array":null,"self_checkin":"No","shift_application_form_id":null,"shift_application_form_id:value":null,"shift_application_form_id:array":null,"shift_attended_form_id":null,"shift_attended_form_id:value":null,"shift_attended_form_id:array":null,"shift_checkin_form_id":null,"shift_checkin_form_id:value":null,"shift_checkin_form_id:array":null,"shift_checkout_form_id":null,"shift_checkout_form_id:value":null,"shift_checkout_form_id:array":null,"shift_precheckin_form_id":null,"shift_precheckin_form_id:value":null,"shift_precheckin_form_id:array":null,"shift_withdraw_form_id":null,"shift_withdraw_form_id:value":null,"shift_withdraw_form_id:array":null,"start_timestamp":"Sep 17, 2026, 3:00 PM","start_timestamp__date":"Sep 17, 2026","start_timestamp__time":"3:00 PM","start_timestamp__offset":" (+10:00 AEST)","start_timestamp__offset_minutes":600,"start_timestamp__dayofweek":"Thursday","updated_at":"Jun 9, 2026, 3:36 PM","updated_at__date":"Jun 9, 2026","updated_at__time":"3:36 PM","updated_at__offset":" (+10:00 AEST)","updated_at__offset_minutes":600,"updated_at__dayofweek":"Tuesday","visibility_hide_groups":"","visibility_show_groups":"","visibility_show_roleoffer":"","info":" - ","event_shift_link_id":1,"event_shift_link_repeat":1,"event_shift_link_name":"test shift link","shift_status_default_id":1,"length":8,"account_id":20000,"account_url":"https://example.rosterfy.com/","is_any_leader":false,"post_shift_feedback_form_completed_at":"","pre_checkin_form_completed_at":"","event_name":null},"relations":[],"permissions":{"read":true,"update":true,"delete":true,"apply":false,"apply_error":"Shift applications not open","apply_error_code":"ES0056","is_unavailable":false,"confirm":false,"reject":false,"selfCheckin":false,"selfCheckout":false,"submitAttendedForm":false,"precheckin":false,"applyWaitlist":false},"attributes":[]},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}],"first_page_url":"https://example.rosterfy.com/api/v2/event/{event}/shift?per_page=5&_locale=en-US&page=1","from":1,"next_page_url":"https://example.rosterfy.com/api/v2/event/{event}/shift?per_page=5&_locale=en-US&page=2","path":"https://example.rosterfy.com/api/v2/event/{event}/shift","per_page":5,"prev_page_url":null,"to":5}]]},"id":"schema_454"},"schema_455":{"kind":"json-schema","data":{"type":"object","properties":{"name":{"type":"string","description":"What the shift is called. Shown to people choosing shifts.","examples":[null]},"timezone":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The timezone the start and end times are given in, as an IANA name such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Australia/Melbourne"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"min_demand":{"type":"integer","description":"The fewest people the shift needs. Defaults to 1.","examples":[1]},"max_demand":{"type":"integer","description":"The most people the shift can take. Applications are refused once it is full.","examples":[1]},"leader_demand":{"type":"integer","description":"How many of those places are for leaders. Defaults to 0.","examples":[1]},"start_timestamp":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the shift starts, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD HH:MM:SS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the shift's timezone."},"children":[]}]}]}],"examples":[null]},"end_timestamp":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the shift ends, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD HH:MM:SS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the shift's timezone."},"children":[]}]}]}],"examples":[null]},"is_virtual":{"type":"boolean","description":"Whether the shift happens online rather than at a place.","examples":[true]},"event_shift_type_id":{"type":"integer","description":"The shift type, which groups shifts for reporting and for the per-type application limits an event can set.","examples":[1]},"event_shift_template_id":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A shift template to build the shift from. The template's values replace anything you send for the fields it defines, unless you also send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"<field>:override"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" as true and are allowed to override locked fields."},"children":[]}]}]}],"examples":[1]},"shift_status_default":{"type":"integer","description":"The status a new application on this shift starts at.","examples":[1]},"shift_confirmed_status_default":{"type":"integer","description":"The status an application moves to when it is confirmed.","examples":[1]},"shift_rejected_status_default":{"type":"integer","description":"The status an application moves to when it is rejected.","examples":[1]},"shift_can_withdraw_default":{"type":"boolean","description":"Whether people can withdraw from the shift themselves.","examples":[true]},"shift_can_withdraw_limit":{"type":"integer","description":"How long before the shift starts withdrawing stops being allowed, in seconds.","examples":[1]},"shift_can_confirm":{"type":"boolean","description":"Whether people can confirm their own place on the shift.","examples":[true]},"shift_can_confirm_limit":{"type":"integer","description":"How long before the shift starts confirming stops being allowed, in seconds.","examples":[1]},"shift_checked_in_status_default":{"type":"integer","description":"The status an assignment moves to on check-in.","examples":[1]},"shift_checked_out_status_default":{"type":"integer","description":"The status an assignment moves to on check-out.","examples":[1]},"address":{"type":"object","description":"Where the shift happens, as an address object. Required on a create unless the shift is virtual or takes its location from a venue.","properties":{},"examples":["{}"]},"headcount_location_venue_id":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The venue the shift happens at. Sending one takes the location from the venue instead of from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"address"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[1]},"certificate_id":{"type":"integer","description":"A certificate awarded for attending the shift.","examples":[1]},"visibility_show_groups":{"type":"array","description":"Only members of these groups can see the shift.","items":{"type":"integer"},"examples":[[]]},"visibility_hide_groups":{"type":"array","description":"Members of these groups cannot see the shift.","items":{"type":"integer"},"examples":[[]]},"visibility_show_roleoffer":{"type":"array","description":"Only people holding one of these role offers can see the shift.","items":{"type":"integer"},"examples":[[]]},"apps_open_timestamp":{"type":"string","description":"When applications open. Before this, applying is refused.","examples":[null]},"apps_close_timestamp":{"type":"string","description":"When applications close. After this, applying is refused.","examples":[null]},"role_offer_id":{"type":"integer","description":"The role offer this shift belongs to.","examples":[1]},"role_offer_address":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Take the shift's location from the role offer rather than from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"address"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[true]},"shift_application_form_id":{"type":"integer","description":"The form someone fills in when applying for this shift.","examples":[1]},"allow_application_form_resubmit":{"type":"boolean","description":"Whether someone can submit the application form again.","examples":[true]},"shift_precheckin_form_id":{"type":"integer","description":"The form filled in at pre-check-in.","examples":[1]},"shift_checkin_form_id":{"type":"integer","description":"The form filled in at check-in.","examples":[1]},"shift_attended_form_id":{"type":"integer","description":"The form filled in once the shift has been attended.","examples":[1]},"shift_checkout_form_id":{"type":"integer","description":"The form filled in at check-out.","examples":[1]},"shift_withdraw_form_id":{"type":"integer","description":"The form filled in when withdrawing.","examples":[1]},"shift_precheckin_open":{"type":"integer","description":"How long before the shift starts pre-check-in opens, in seconds.","examples":[1]},"max_group_demand":{"type":"integer","description":"How many places a single group booking can take.","examples":[1]},"group_booking_ttl":{"type":"integer","description":"How long a group booking is held before it lapses, in seconds.","examples":[1]},"self_checkin":{"type":"boolean","description":"Whether people can check themselves in to the shift.","examples":[true]},"self_checkin_open":{"type":"integer","description":"How long before the shift starts self check-in opens, in seconds.","examples":[1]},"self_checkin_close":{"type":"integer","description":"How long after the shift starts self check-in closes, in seconds.","examples":[1]},"self_checkout_close":{"type":"integer","description":"How long after the shift ends self check-out closes, in seconds.","examples":[1]},"checkin_close":{"type":"integer","description":"How long after the shift ends check-in closes, in seconds.","examples":[1]},"geofence_checkin_limit":{"type":"integer","description":"How close to the shift's location someone has to be to check in, in metres.","examples":[1]},"checkin_visible_attributes":{"type":"array","description":"Which of a person's attributes are shown on the check-in screen.","items":{"type":"integer"},"examples":[[]]},"training_ids":{"type":"array","description":"Training people must have completed before they can be placed on the shift.","items":{"type":"integer"},"examples":[[]]},"publish":{"type":"boolean","description":"Whether the shift is visible to people who can apply for it. Ignored from a caller who cannot publish shifts.","examples":[true]},"public":{"type":"boolean","description":"Whether the shift can be seen without signing in, on a public event.","examples":[true]},"post_feedback_form":{"type":"integer","description":"The form people fill in about the shift afterwards.","examples":[1]},"shift_leader_feedback_form_id":{"type":"integer","description":"The form a leader fills in about the shift.","examples":[1]},"shift_enable_waitlist_default":{"type":"boolean","description":"Whether people can join a waitlist once the shift is full.","examples":[true]},"max_waitlist":{"type":"integer","description":"How many people the waitlist holds.","examples":[1]},"sort_order":{"type":"integer","description":"Where the shift sits when shifts are shown in a fixed order.","examples":[1]},"minimum_dob":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Latest date of birth allowed on the shift. Cannot be sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"minimum_age"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"minimum_age":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Youngest age allowed on the shift, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"years:months"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"maximum_dob":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Earliest date of birth allowed on the shift. Cannot be sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"maximum_age"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"maximum_age":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Oldest age allowed on the shift, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"years:months"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"price_excluding_tax":{"type":"number","description":"What taking this shift costs the person, before tax.","examples":[1.23]},"tax_percentage":{"type":"integer","description":"Tax charged on the price, as a percentage between 0 and 100.","examples":[1]},"cost_description":{"type":"string","description":"Free text shown alongside the price.","examples":[null]},"all_default":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fill the shift in from the event: the event's address and its shift defaults, plus "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"publish"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 1, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"max_demand"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 1, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"min_demand"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 1 and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"leader_demand"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 0. Anything you send explicitly wins over the value this would have supplied, so it is a starting point rather than an override. Without it a create needs the full body."},"children":[]}]}]}],"examples":[true]},"no_shift_time":{"type":"boolean","description":"Treat the shift as all-day: the times you send are reduced to dates and the shift is stored spanning them.","examples":[true]},"has_age_limit":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"false"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to clear all four age limits on the shift. Read and then discarded; it is not stored."},"children":[]}]}]}],"examples":[true]},"published":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An accepted alias for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"publish"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", used only if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"publish"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" itself is absent."},"children":[]}]}]}],"examples":[true]},"custom_*":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A custom attribute, named by its code - custom_shirt_size, for example. The value follows the attribute's own type, so it may be a string, a number, a boolean or a list. See the custom attributes documentation."},"children":[]}]}]}],"examples":[null]}},"required":["name","timezone","min_demand","max_demand","leader_demand","start_timestamp","end_timestamp","shift_status_default","shift_confirmed_status_default","shift_rejected_status_default","shift_checked_in_status_default","shift_checked_out_status_default","address","publish"]},"id":"schema_455"},"schema_456":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"name":{"type":"string","examples":["Probe shift"]},"timezone":{"type":"string","examples":["Australia/Melbourne"]},"min_demand":{"type":"integer","examples":[1]},"max_demand":{"type":"integer","examples":[1]},"leader_demand":{"type":"integer","examples":[0]},"start_timestamp":{"type":"string","examples":["2027-01-01 09:00:00"]},"end_timestamp":{"type":"string","examples":["2027-01-01 17:00:00"]},"is_virtual":{"type":"integer","examples":[0]},"shift_status_default":{"type":"integer","examples":[1]},"shift_confirmed_status_default":{"type":"integer","examples":[3]},"shift_rejected_status_default":{"type":"integer","examples":[6]},"shift_can_withdraw_default":{"type":"integer","examples":[1]},"shift_can_withdraw_limit":{"type":"integer","examples":[0]},"shift_can_confirm":{"type":"integer","examples":[1]},"shift_can_confirm_limit":{"type":"integer","examples":[0]},"shift_checked_in_status_default":{"type":"integer","examples":[4]},"shift_checked_out_status_default":{"type":"integer","examples":[4]},"visibility_show_groups":{"type":"array","examples":[[]]},"visibility_hide_groups":{"type":"array","examples":[[]]},"visibility_show_roleoffer":{"type":"array","examples":[[]]},"role_offer_address":{"type":"integer","examples":[0]},"shift_precheckin_open":{"type":"integer","examples":[0]},"self_checkin":{"type":"integer","examples":[0]},"self_checkin_open":{"type":"integer","examples":[1800]},"self_checkin_close":{"type":"integer","examples":[1800]},"self_checkout_close":{"type":"integer","examples":[1800]},"checkin_close":{"type":"integer","examples":[0]},"checkin_visible_attributes":{"type":"array","examples":[[]]},"publish":{"type":"integer","examples":[1]},"public":{"type":"integer","examples":[0]},"shift_enable_waitlist_default":{"type":"integer","examples":[0]},"max_waitlist":{"type":"integer","examples":[0]},"sort_order":{"type":"integer","examples":[0]},"event_id":{"type":"integer","examples":[1001]},"updated_at":{"type":"string","examples":["2026-08-12T04:57:59.000000Z"]},"created_at":{"type":"string","examples":["2026-08-12T04:57:59.000000Z"]},"id":{"type":"integer","examples":[2001]},"cost_description":{"type":["string","null"],"examples":[null]},"event_shift_description":{"type":"string","examples":[""]},"address":{"type":"object","properties":{"iso":{"type":"string","examples":["AUS"]},"region_code":{"type":"string","examples":["VIC"]},"coordinates":{"type":"object","properties":{"latitude":{"type":"string","examples":["-37.814000"]},"longitude":{"type":"string","examples":["144.963100"]}}},"street_address_1":{"type":"string","examples":["1 Example Street"]},"street_address_2":{"type":["string","null"],"examples":[null]},"street_address_3":{"type":["string","null"],"examples":[null]},"city":{"type":"string","examples":["Melbourne"]},"postcode":{"type":"string","examples":["3000"]},"region":{"type":"string","examples":["VIC"]},"country":{"type":"string","examples":["AU"]},"latitude":{"type":"string","examples":["-37.814000"]},"longitude":{"type":"string","examples":["144.963100"]}}}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:example:20000:shift:2001"]},"address":{"type":"string","examples":["1 Example Street\nMelbourne\nVictoria\nAustralia\n3000"]},"address_oneline":{"type":"string","examples":["1 Example Street, Melbourne, Victoria, Australia, 3000"]},"address.country":{"type":"string","examples":["Australia"]},"address.country:raw":{"type":"string","examples":["AUS"]},"address.city":{"type":"string","examples":["Melbourne"]},"address.region":{"type":"string","examples":["Victoria"]},"address.region:raw":{"type":"string","examples":["VIC"]},"address.postcode":{"type":"string","examples":["3000"]},"address.street_address_1":{"type":"string","examples":["1 Example Street"]},"address.street_address_2":{"type":"string","examples":[""]},"address.street_address_3":{"type":"string","examples":[""]},"address.latitude":{"type":"string","examples":["-37.814000"]},"address.longitude":{"type":"string","examples":["144.963100"]},"created_at":{"type":"string","examples":["Aug 12, 2026, 2:57 PM"]},"created_at__date":{"type":"string","examples":["Aug 12, 2026"]},"created_at__time":{"type":"string","examples":["2:57 PM"]},"created_at__offset":{"type":"string","examples":[" (+10:00 AEST)"]},"created_at__offset_minutes":{"type":"integer","examples":[600]},"created_at__dayofweek":{"type":"string","examples":["Wednesday"]},"end_timestamp":{"type":"string","examples":["Jan 2, 2027, 4:00 AM"]},"end_timestamp__date":{"type":"string","examples":["Jan 2, 2027"]},"end_timestamp__time":{"type":"string","examples":["4:00 AM"]},"end_timestamp__offset":{"type":"string","examples":[" (+11:00 AEDT)"]},"end_timestamp__offset_minutes":{"type":"integer","examples":[660]},"end_timestamp__dayofweek":{"type":"string","examples":["Saturday"]},"event_shift_template_id":{"type":["string","null"],"examples":[null]},"event_shift_template_id:value":{"type":["string","null"],"examples":[null]},"event_shift_template_id:array":{"type":["string","null"],"examples":[null]},"event_shift_type_id":{"type":["string","null"],"examples":[null]},"event_shift_type_id:value":{"type":["string","null"],"examples":[null]},"event_shift_type_id:array":{"type":["string","null"],"examples":[null]},"headcount_location_venue_id":{"type":["string","null"],"examples":[null]},"headcount_location_venue_id:value":{"type":["string","null"],"examples":[null]},"headcount_location_venue_id:array":{"type":["string","null"],"examples":[null]},"is_virtual":{"type":"string","examples":["No"]},"minimum_age":{"type":"string","examples":[""]},"name":{"type":"string","examples":["Probe shift"]},"no_shift_time":{"type":"string","examples":["No"]},"post_feedback_form":{"type":["string","null"],"examples":[null]},"post_feedback_form:value":{"type":["string","null"],"examples":[null]},"post_feedback_form:array":{"type":["string","null"],"examples":[null]},"public":{"type":"string","examples":["No"]},"publish":{"type":"string","examples":["Yes"]},"role_offer_address":{"type":"string","examples":["No"]},"role_offer_id":{"type":["string","null"],"examples":[null]},"role_offer_id:value":{"type":["string","null"],"examples":[null]},"role_offer_id:array":{"type":["string","null"],"examples":[null]},"self_checkin":{"type":"string","examples":["No"]},"shift_application_form_id":{"type":["string","null"],"examples":[null]},"shift_application_form_id:value":{"type":["string","null"],"examples":[null]},"shift_application_form_id:array":{"type":["string","null"],"examples":[null]},"shift_attended_form_id":{"type":["string","null"],"examples":[null]},"shift_attended_form_id:value":{"type":["string","null"],"examples":[null]},"shift_attended_form_id:array":{"type":["string","null"],"examples":[null]},"shift_checkin_form_id":{"type":["string","null"],"examples":[null]},"shift_checkin_form_id:value":{"type":["string","null"],"examples":[null]},"shift_checkin_form_id:array":{"type":["string","null"],"examples":[null]},"shift_checkout_form_id":{"type":["string","null"],"examples":[null]},"shift_checkout_form_id:value":{"type":["string","null"],"examples":[null]},"shift_checkout_form_id:array":{"type":["string","null"],"examples":[null]},"shift_precheckin_form_id":{"type":["string","null"],"examples":[null]},"shift_precheckin_form_id:value":{"type":["string","null"],"examples":[null]},"shift_precheckin_form_id:array":{"type":["string","null"],"examples":[null]},"shift_withdraw_form_id":{"type":["string","null"],"examples":[null]},"shift_withdraw_form_id:value":{"type":["string","null"],"examples":[null]},"shift_withdraw_form_id:array":{"type":["string","null"],"examples":[null]},"start_timestamp":{"type":"string","examples":["Jan 1, 2027, 8:00 PM"]},"start_timestamp__date":{"type":"string","examples":["Jan 1, 2027"]},"start_timestamp__time":{"type":"string","examples":["8:00 PM"]},"start_timestamp__offset":{"type":"string","examples":[" (+11:00 AEDT)"]},"start_timestamp__offset_minutes":{"type":"integer","examples":[660]},"start_timestamp__dayofweek":{"type":"string","examples":["Friday"]},"updated_at":{"type":"string","examples":["Aug 12, 2026, 2:57 PM"]},"updated_at__date":{"type":"string","examples":["Aug 12, 2026"]},"updated_at__time":{"type":"string","examples":["2:57 PM"]},"updated_at__offset":{"type":"string","examples":[" (+10:00 AEST)"]},"updated_at__offset_minutes":{"type":"integer","examples":[600]},"updated_at__dayofweek":{"type":"string","examples":["Wednesday"]},"visibility_hide_groups":{"type":"string","examples":[""]},"visibility_show_groups":{"type":"string","examples":[""]},"visibility_show_roleoffer":{"type":"string","examples":[""]},"info":{"type":"string","examples":[" - Probe shift"]},"event_shift_link_id":{"type":["string","null"],"examples":[null]},"event_shift_link_repeat":{"type":"integer","examples":[0]},"event_shift_link_name":{"type":"string","examples":[""]},"shift_status_default_id":{"type":"integer","examples":[1]},"length":{"type":"integer","examples":[8]},"account_id":{"type":"integer","examples":[20000]},"account_url":{"type":"string","examples":["https://example.rosterfy.com/"]},"is_any_leader":{"type":"boolean","examples":[false]},"post_shift_feedback_form_completed_at":{"type":"string","examples":[""]},"pre_checkin_form_completed_at":{"type":"string","examples":[""]},"event_name":{"type":["string","null"],"examples":[null]}}},"relations":{"type":"object","properties":{}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]},"apply":{"type":"boolean","examples":[false]},"apply_error":{"type":"string","examples":["Shift applications not open"]},"apply_error_code":{"type":"string","examples":["ES0056"]},"is_unavailable":{"type":"boolean","examples":[false]},"confirm":{"type":"boolean","examples":[false]},"reject":{"type":"boolean","examples":[false]},"selfCheckin":{"type":"boolean","examples":[false]},"selfCheckout":{"type":"boolean","examples":[false]},"submitAttendedForm":{"type":"boolean","examples":[false]},"precheckin":{"type":"boolean","examples":[false]},"applyWaitlist":{"type":"boolean","examples":[false]}}},"attributes":{"type":"object","properties":{}}},"examples":[{"object":{"name":"Probe shift","timezone":"Australia/Melbourne","min_demand":1,"max_demand":1,"leader_demand":0,"start_timestamp":"2027-01-01 09:00:00","end_timestamp":"2027-01-01 17:00:00","is_virtual":0,"shift_status_default":1,"shift_confirmed_status_default":3,"shift_rejected_status_default":6,"shift_can_withdraw_default":1,"shift_can_withdraw_limit":0,"shift_can_confirm":1,"shift_can_confirm_limit":0,"shift_checked_in_status_default":4,"shift_checked_out_status_default":4,"visibility_show_groups":[],"visibility_hide_groups":[],"visibility_show_roleoffer":[],"role_offer_address":0,"shift_precheckin_open":0,"self_checkin":0,"self_checkin_open":1800,"self_checkin_close":1800,"self_checkout_close":1800,"checkin_close":0,"checkin_visible_attributes":[],"publish":1,"public":0,"shift_enable_waitlist_default":0,"max_waitlist":0,"sort_order":0,"event_id":1001,"updated_at":"2026-08-12T04:57:59.000000Z","created_at":"2026-08-12T04:57:59.000000Z","id":2001,"cost_description":null,"event_shift_description":"","address":{"iso":"AUS","region_code":"VIC","coordinates":{"latitude":"-37.814000","longitude":"144.963100"},"street_address_1":"1 Example Street","street_address_2":null,"street_address_3":null,"city":"Melbourne","postcode":"3000","region":"VIC","country":"AU","latitude":"-37.814000","longitude":"144.963100"}},"nice":{"rrn":"rrn:example:20000:shift:2001","address":"1 Example Street\nMelbourne\nVictoria\nAustralia\n3000","address_oneline":"1 Example Street, Melbourne, Victoria, Australia, 3000","address.country":"Australia","address.country:raw":"AUS","address.city":"Melbourne","address.region":"Victoria","address.region:raw":"VIC","address.postcode":"3000","address.street_address_1":"1 Example Street","address.street_address_2":"","address.street_address_3":"","address.latitude":"-37.814000","address.longitude":"144.963100","created_at":"Aug 12, 2026, 2:57 PM","created_at__date":"Aug 12, 2026","created_at__time":"2:57 PM","created_at__offset":" (+10:00 AEST)","created_at__offset_minutes":600,"created_at__dayofweek":"Wednesday","end_timestamp":"Jan 2, 2027, 4:00 AM","end_timestamp__date":"Jan 2, 2027","end_timestamp__time":"4:00 AM","end_timestamp__offset":" (+11:00 AEDT)","end_timestamp__offset_minutes":660,"end_timestamp__dayofweek":"Saturday","event_shift_template_id":null,"event_shift_template_id:value":null,"event_shift_template_id:array":null,"event_shift_type_id":null,"event_shift_type_id:value":null,"event_shift_type_id:array":null,"headcount_location_venue_id":null,"headcount_location_venue_id:value":null,"headcount_location_venue_id:array":null,"is_virtual":"No","minimum_age":"","name":"Probe shift","no_shift_time":"No","post_feedback_form":null,"post_feedback_form:value":null,"post_feedback_form:array":null,"public":"No","publish":"Yes","role_offer_address":"No","role_offer_id":null,"role_offer_id:value":null,"role_offer_id:array":null,"self_checkin":"No","shift_application_form_id":null,"shift_application_form_id:value":null,"shift_application_form_id:array":null,"shift_attended_form_id":null,"shift_attended_form_id:value":null,"shift_attended_form_id:array":null,"shift_checkin_form_id":null,"shift_checkin_form_id:value":null,"shift_checkin_form_id:array":null,"shift_checkout_form_id":null,"shift_checkout_form_id:value":null,"shift_checkout_form_id:array":null,"shift_precheckin_form_id":null,"shift_precheckin_form_id:value":null,"shift_precheckin_form_id:array":null,"shift_withdraw_form_id":null,"shift_withdraw_form_id:value":null,"shift_withdraw_form_id:array":null,"start_timestamp":"Jan 1, 2027, 8:00 PM","start_timestamp__date":"Jan 1, 2027","start_timestamp__time":"8:00 PM","start_timestamp__offset":" (+11:00 AEDT)","start_timestamp__offset_minutes":660,"start_timestamp__dayofweek":"Friday","updated_at":"Aug 12, 2026, 2:57 PM","updated_at__date":"Aug 12, 2026","updated_at__time":"2:57 PM","updated_at__offset":" (+10:00 AEST)","updated_at__offset_minutes":600,"updated_at__dayofweek":"Wednesday","visibility_hide_groups":"","visibility_show_groups":"","visibility_show_roleoffer":"","info":" - Probe shift","event_shift_link_id":null,"event_shift_link_repeat":0,"event_shift_link_name":"","shift_status_default_id":1,"length":8,"account_id":20000,"account_url":"https://example.rosterfy.com/","is_any_leader":false,"post_shift_feedback_form_completed_at":"","pre_checkin_form_completed_at":"","event_name":null},"relations":{},"permissions":{"read":true,"update":true,"delete":true,"apply":false,"apply_error":"Shift applications not open","apply_error_code":"ES0056","is_unavailable":false,"confirm":false,"reject":false,"selfCheckin":false,"selfCheckout":false,"submitAttendedForm":false,"precheckin":false,"applyWaitlist":false},"attributes":{}}]},"id":"schema_456"},"schema_457":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[2001]},"event_id":{"type":"integer","examples":[1001]},"event_shift_type_id":{"type":["string","null"],"examples":[null]},"event_shift_template_id":{"type":["string","null"],"examples":[null]},"journey_id":{"type":["string","null"],"examples":[null]},"min_demand":{"type":"integer","examples":[10]},"max_demand":{"type":"integer","examples":[10]},"leader_demand":{"type":"integer","examples":[1]},"start_timestamp":{"type":"string","examples":["2026-09-17 05:00:00"]},"end_timestamp":{"type":"string","examples":["2026-09-17 13:00:00"]},"timezone":{"type":"string","examples":["Australia/Melbourne"]},"no_shift_time":{"type":"integer","examples":[0]},"apps_open_timestamp":{"type":["string","null"],"examples":[null]},"apps_close_timestamp":{"type":["string","null"],"examples":[null]},"headcount_location_venue_id":{"type":["string","null"],"examples":[null]},"shift_confirmed_status_default":{"type":"integer","examples":[3]},"shift_rejected_status_default":{"type":"integer","examples":[6]},"journey_complete_status":{"type":["string","null"],"examples":[null]},"shift_can_withdraw_default":{"type":"integer","examples":[1]},"shift_can_confirm":{"type":"integer","examples":[1]},"shift_can_confirm_limit":{"type":"integer","examples":[0]},"shift_can_withdraw_limit":{"type":"integer","examples":[0]},"shift_checked_in_status_default":{"type":"integer","examples":[4]},"shift_checked_out_status_default":{"type":"integer","examples":[4]},"certificate_id":{"type":["string","null"],"examples":[null]},"shift_application_form_id":{"type":["string","null"],"examples":[null]},"allow_application_form_resubmit":{"type":"integer","examples":[0]},"shift_checkin_form_id":{"type":["string","null"],"examples":[null]},"shift_attended_form_id":{"type":["string","null"],"examples":[null]},"shift_checkout_form_id":{"type":["string","null"],"examples":[null]},"shift_precheckin_form_id":{"type":["string","null"],"examples":[null]},"shift_withdraw_form_id":{"type":["string","null"],"examples":[null]},"training_ids":{"type":["string","null"],"examples":[null]},"visibility_show_groups":{"type":"array","examples":[[]]},"visibility_hide_groups":{"type":"array","examples":[[]]},"visibility_show_roleoffer":{"type":"array","examples":[[]]},"role_offer_id":{"type":["string","null"],"examples":[null]},"role_offer_address":{"type":"integer","examples":[0]},"checkin_visible_attributes":{"type":"array","examples":[[]]},"shift_enable_waitlist_default":{"type":"integer","examples":[0]},"max_waitlist":{"type":"integer","examples":[0]},"group_booking_ttl":{"type":["string","null"],"examples":[null]},"max_group_demand":{"type":["string","null"],"examples":[null]},"max_group_size":{"type":["string","null"],"examples":[null]},"reserved_expiry":{"type":["string","null"],"examples":[null]},"minimum_dob":{"type":["string","null"],"examples":[null]},"minimum_age":{"type":["string","null"],"examples":[null]},"maximum_dob":{"type":["string","null"],"examples":[null]},"maximum_age":{"type":["string","null"],"examples":[null]},"self_checkin":{"type":"integer","examples":[0]},"self_checkin_open":{"type":"integer","examples":[1800]},"self_checkin_close":{"type":"integer","examples":[1800]},"self_checkout_close":{"type":"integer","examples":[1800]},"checkin_close":{"type":"integer","examples":[0]},"shift_precheckin_open":{"type":"integer","examples":[0]},"break":{"type":"integer","examples":[0]},"post_feedback_form":{"type":["string","null"],"examples":[null]},"shift_leader_feedback_form_id":{"type":["string","null"],"examples":[null]},"is_virtual":{"type":"integer","examples":[0]},"geofence_checkin_limit":{"type":["string","null"],"examples":[null]},"tax":{"type":["string","null"],"examples":[null]},"price_excluding_tax":{"type":"integer","examples":[0]},"tax_percentage":{"type":["string","null"],"examples":[null]},"publish":{"type":"integer","examples":[0]},"public":{"type":"integer","examples":[0]},"sort_order":{"type":"integer","examples":[0]},"is_cancelled":{"type":"integer","examples":[0]},"deleted_at":{"type":["string","null"],"examples":[null]},"is_erased":{"type":"integer","examples":[0]},"is_draft":{"type":"boolean","examples":[false]},"created_at":{"type":"string","examples":["2026-06-09T05:36:10.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:10.000000Z"]},"deleted_by":{"type":["string","null"],"examples":[null]},"cost_description":{"type":["string","null"],"examples":[null]},"event_shift_description":{"type":"string","examples":[""]},"name":{"type":["string","null"],"examples":[null]},"address":{"type":"object","properties":{"iso":{"type":"string","examples":["AUS"]},"region_code":{"type":"string","examples":["VIC"]},"coordinates":{"type":"object","properties":{"latitude":{"type":"string","examples":["-37.814000"]},"longitude":{"type":"string","examples":["144.963100"]}}},"street_address_1":{"type":"string","examples":["1 Example Street"]},"street_address_2":{"type":["string","null"],"examples":[null]},"street_address_3":{"type":["string","null"],"examples":[null]},"city":{"type":"string","examples":["Melbourne"]},"postcode":{"type":"string","examples":["3000"]},"region":{"type":"string","examples":["VIC"]},"country":{"type":"string","examples":["AU"]},"latitude":{"type":"string","examples":["-37.814000"]},"longitude":{"type":"string","examples":["144.963100"]}}}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:example:20000:shift:2001"]},"address":{"type":"string","examples":["1 Example Street\nMelbourne\nVictoria\nAustralia\n3000"]},"address_oneline":{"type":"string","examples":["1 Example Street, Melbourne, Victoria, Australia, 3000"]},"address.country":{"type":"string","examples":["Australia"]},"address.country:raw":{"type":"string","examples":["AUS"]},"address.city":{"type":"string","examples":["Melbourne"]},"address.region":{"type":"string","examples":["Victoria"]},"address.region:raw":{"type":"string","examples":["VIC"]},"address.postcode":{"type":"string","examples":["3000"]},"address.street_address_1":{"type":"string","examples":["1 Example Street"]},"address.street_address_2":{"type":"string","examples":[""]},"address.street_address_3":{"type":"string","examples":[""]},"address.latitude":{"type":"string","examples":["-37.814000"]},"address.longitude":{"type":"string","examples":["144.963100"]},"created_at":{"type":"string","examples":["Jun 9, 2026, 3:36 PM"]},"created_at__date":{"type":"string","examples":["Jun 9, 2026"]},"created_at__time":{"type":"string","examples":["3:36 PM"]},"created_at__offset":{"type":"string","examples":[" (+10:00 AEST)"]},"created_at__offset_minutes":{"type":"integer","examples":[600]},"created_at__dayofweek":{"type":"string","examples":["Tuesday"]},"end_timestamp":{"type":"string","examples":["Sep 17, 2026, 11:00 PM"]},"end_timestamp__date":{"type":"string","examples":["Sep 17, 2026"]},"end_timestamp__time":{"type":"string","examples":["11:00 PM"]},"end_timestamp__offset":{"type":"string","examples":[" (+10:00 AEST)"]},"end_timestamp__offset_minutes":{"type":"integer","examples":[600]},"end_timestamp__dayofweek":{"type":"string","examples":["Thursday"]},"event_shift_template_id":{"type":["string","null"],"examples":[null]},"event_shift_template_id:value":{"type":["string","null"],"examples":[null]},"event_shift_template_id:array":{"type":["string","null"],"examples":[null]},"event_shift_type_id":{"type":["string","null"],"examples":[null]},"event_shift_type_id:value":{"type":["string","null"],"examples":[null]},"event_shift_type_id:array":{"type":["string","null"],"examples":[null]},"headcount_location_venue_id":{"type":["string","null"],"examples":[null]},"headcount_location_venue_id:value":{"type":["string","null"],"examples":[null]},"headcount_location_venue_id:array":{"type":["string","null"],"examples":[null]},"is_virtual":{"type":"string","examples":["No"]},"minimum_age":{"type":"string","examples":[""]},"name":{"type":"string","examples":[""]},"no_shift_time":{"type":"string","examples":["No"]},"post_feedback_form":{"type":["string","null"],"examples":[null]},"post_feedback_form:value":{"type":["string","null"],"examples":[null]},"post_feedback_form:array":{"type":["string","null"],"examples":[null]},"public":{"type":"string","examples":["No"]},"publish":{"type":"string","examples":["No"]},"role_offer_address":{"type":"string","examples":["No"]},"role_offer_id":{"type":["string","null"],"examples":[null]},"role_offer_id:value":{"type":["string","null"],"examples":[null]},"role_offer_id:array":{"type":["string","null"],"examples":[null]},"self_checkin":{"type":"string","examples":["No"]},"shift_application_form_id":{"type":["string","null"],"examples":[null]},"shift_application_form_id:value":{"type":["string","null"],"examples":[null]},"shift_application_form_id:array":{"type":["string","null"],"examples":[null]},"shift_attended_form_id":{"type":["string","null"],"examples":[null]},"shift_attended_form_id:value":{"type":["string","null"],"examples":[null]},"shift_attended_form_id:array":{"type":["string","null"],"examples":[null]},"shift_checkin_form_id":{"type":["string","null"],"examples":[null]},"shift_checkin_form_id:value":{"type":["string","null"],"examples":[null]},"shift_checkin_form_id:array":{"type":["string","null"],"examples":[null]},"shift_checkout_form_id":{"type":["string","null"],"examples":[null]},"shift_checkout_form_id:value":{"type":["string","null"],"examples":[null]},"shift_checkout_form_id:array":{"type":["string","null"],"examples":[null]},"shift_precheckin_form_id":{"type":["string","null"],"examples":[null]},"shift_precheckin_form_id:value":{"type":["string","null"],"examples":[null]},"shift_precheckin_form_id:array":{"type":["string","null"],"examples":[null]},"shift_withdraw_form_id":{"type":["string","null"],"examples":[null]},"shift_withdraw_form_id:value":{"type":["string","null"],"examples":[null]},"shift_withdraw_form_id:array":{"type":["string","null"],"examples":[null]},"start_timestamp":{"type":"string","examples":["Sep 17, 2026, 3:00 PM"]},"start_timestamp__date":{"type":"string","examples":["Sep 17, 2026"]},"start_timestamp__time":{"type":"string","examples":["3:00 PM"]},"start_timestamp__offset":{"type":"string","examples":[" (+10:00 AEST)"]},"start_timestamp__offset_minutes":{"type":"integer","examples":[600]},"start_timestamp__dayofweek":{"type":"string","examples":["Thursday"]},"updated_at":{"type":"string","examples":["Jun 9, 2026, 3:36 PM"]},"updated_at__date":{"type":"string","examples":["Jun 9, 2026"]},"updated_at__time":{"type":"string","examples":["3:36 PM"]},"updated_at__offset":{"type":"string","examples":[" (+10:00 AEST)"]},"updated_at__offset_minutes":{"type":"integer","examples":[600]},"updated_at__dayofweek":{"type":"string","examples":["Tuesday"]},"visibility_hide_groups":{"type":"string","examples":[""]},"visibility_show_groups":{"type":"string","examples":[""]},"visibility_show_roleoffer":{"type":"string","examples":[""]},"info":{"type":"string","examples":[" - "]},"event_shift_link_id":{"type":"integer","examples":[1]},"event_shift_link_repeat":{"type":"integer","examples":[1]},"event_shift_link_name":{"type":"string","examples":["test shift link"]},"shift_status_default_id":{"type":"integer","examples":[1]},"length":{"type":"integer","examples":[8]},"account_id":{"type":"integer","examples":[20000]},"account_url":{"type":"string","examples":["https://example.rosterfy.com/"]},"is_any_leader":{"type":"boolean","examples":[false]},"post_shift_feedback_form_completed_at":{"type":"string","examples":[""]},"pre_checkin_form_completed_at":{"type":"string","examples":[""]},"event_name":{"type":["string","null"],"examples":[null]}}},"relations":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]},"apply":{"type":"boolean","examples":[false]},"apply_error":{"type":"string","examples":["Shift applications not open"]},"apply_error_code":{"type":"string","examples":["ES0056"]},"is_unavailable":{"type":"boolean","examples":[false]},"confirm":{"type":"boolean","examples":[false]},"reject":{"type":"boolean","examples":[false]},"selfCheckin":{"type":"boolean","examples":[false]},"selfCheckout":{"type":"boolean","examples":[false]},"submitAttendedForm":{"type":"boolean","examples":[false]},"precheckin":{"type":"boolean","examples":[false]},"applyWaitlist":{"type":"boolean","examples":[false]}}},"attributes":{"type":"object","properties":{}}},"examples":[{"object":{"id":2001,"event_id":1001,"event_shift_type_id":null,"event_shift_template_id":null,"journey_id":null,"min_demand":10,"max_demand":10,"leader_demand":1,"start_timestamp":"2026-09-17 05:00:00","end_timestamp":"2026-09-17 13:00:00","timezone":"Australia/Melbourne","no_shift_time":0,"apps_open_timestamp":null,"apps_close_timestamp":null,"headcount_location_venue_id":null,"shift_confirmed_status_default":3,"shift_rejected_status_default":6,"journey_complete_status":null,"shift_can_withdraw_default":1,"shift_can_confirm":1,"shift_can_confirm_limit":0,"shift_can_withdraw_limit":0,"shift_checked_in_status_default":4,"shift_checked_out_status_default":4,"certificate_id":null,"shift_application_form_id":null,"allow_application_form_resubmit":0,"shift_checkin_form_id":null,"shift_attended_form_id":null,"shift_checkout_form_id":null,"shift_precheckin_form_id":null,"shift_withdraw_form_id":null,"training_ids":null,"visibility_show_groups":[],"visibility_hide_groups":[],"visibility_show_roleoffer":[],"role_offer_id":null,"role_offer_address":0,"checkin_visible_attributes":[],"shift_enable_waitlist_default":0,"max_waitlist":0,"group_booking_ttl":null,"max_group_demand":null,"max_group_size":null,"reserved_expiry":null,"minimum_dob":null,"minimum_age":null,"maximum_dob":null,"maximum_age":null,"self_checkin":0,"self_checkin_open":1800,"self_checkin_close":1800,"self_checkout_close":1800,"checkin_close":0,"shift_precheckin_open":0,"break":0,"post_feedback_form":null,"shift_leader_feedback_form_id":null,"is_virtual":0,"geofence_checkin_limit":null,"tax":null,"price_excluding_tax":0,"tax_percentage":null,"publish":0,"public":0,"sort_order":0,"is_cancelled":0,"deleted_at":null,"is_erased":0,"is_draft":false,"created_at":"2026-06-09T05:36:10.000000Z","updated_at":"2026-06-09T05:36:10.000000Z","deleted_by":null,"cost_description":null,"event_shift_description":"","name":null,"address":{"iso":"AUS","region_code":"VIC","coordinates":{"latitude":"-37.814000","longitude":"144.963100"},"street_address_1":"1 Example Street","street_address_2":null,"street_address_3":null,"city":"Melbourne","postcode":"3000","region":"VIC","country":"AU","latitude":"-37.814000","longitude":"144.963100"}},"nice":{"rrn":"rrn:example:20000:shift:2001","address":"1 Example Street\nMelbourne\nVictoria\nAustralia\n3000","address_oneline":"1 Example Street, Melbourne, Victoria, Australia, 3000","address.country":"Australia","address.country:raw":"AUS","address.city":"Melbourne","address.region":"Victoria","address.region:raw":"VIC","address.postcode":"3000","address.street_address_1":"1 Example Street","address.street_address_2":"","address.street_address_3":"","address.latitude":"-37.814000","address.longitude":"144.963100","created_at":"Jun 9, 2026, 3:36 PM","created_at__date":"Jun 9, 2026","created_at__time":"3:36 PM","created_at__offset":" (+10:00 AEST)","created_at__offset_minutes":600,"created_at__dayofweek":"Tuesday","end_timestamp":"Sep 17, 2026, 11:00 PM","end_timestamp__date":"Sep 17, 2026","end_timestamp__time":"11:00 PM","end_timestamp__offset":" (+10:00 AEST)","end_timestamp__offset_minutes":600,"end_timestamp__dayofweek":"Thursday","event_shift_template_id":null,"event_shift_template_id:value":null,"event_shift_template_id:array":null,"event_shift_type_id":null,"event_shift_type_id:value":null,"event_shift_type_id:array":null,"headcount_location_venue_id":null,"headcount_location_venue_id:value":null,"headcount_location_venue_id:array":null,"is_virtual":"No","minimum_age":"","name":"","no_shift_time":"No","post_feedback_form":null,"post_feedback_form:value":null,"post_feedback_form:array":null,"public":"No","publish":"No","role_offer_address":"No","role_offer_id":null,"role_offer_id:value":null,"role_offer_id:array":null,"self_checkin":"No","shift_application_form_id":null,"shift_application_form_id:value":null,"shift_application_form_id:array":null,"shift_attended_form_id":null,"shift_attended_form_id:value":null,"shift_attended_form_id:array":null,"shift_checkin_form_id":null,"shift_checkin_form_id:value":null,"shift_checkin_form_id:array":null,"shift_checkout_form_id":null,"shift_checkout_form_id:value":null,"shift_checkout_form_id:array":null,"shift_precheckin_form_id":null,"shift_precheckin_form_id:value":null,"shift_precheckin_form_id:array":null,"shift_withdraw_form_id":null,"shift_withdraw_form_id:value":null,"shift_withdraw_form_id:array":null,"start_timestamp":"Sep 17, 2026, 3:00 PM","start_timestamp__date":"Sep 17, 2026","start_timestamp__time":"3:00 PM","start_timestamp__offset":" (+10:00 AEST)","start_timestamp__offset_minutes":600,"start_timestamp__dayofweek":"Thursday","updated_at":"Jun 9, 2026, 3:36 PM","updated_at__date":"Jun 9, 2026","updated_at__time":"3:36 PM","updated_at__offset":" (+10:00 AEST)","updated_at__offset_minutes":600,"updated_at__dayofweek":"Tuesday","visibility_hide_groups":"","visibility_show_groups":"","visibility_show_roleoffer":"","info":" - ","event_shift_link_id":1,"event_shift_link_repeat":1,"event_shift_link_name":"test shift link","shift_status_default_id":1,"length":8,"account_id":20000,"account_url":"https://example.rosterfy.com/","is_any_leader":false,"post_shift_feedback_form_completed_at":"","pre_checkin_form_completed_at":"","event_name":null},"relations":[],"permissions":{"read":true,"update":true,"delete":true,"apply":false,"apply_error":"Shift applications not open","apply_error_code":"ES0056","is_unavailable":false,"confirm":false,"reject":false,"selfCheckin":false,"selfCheckout":false,"submitAttendedForm":false,"precheckin":false,"applyWaitlist":false},"attributes":{}}]},"id":"schema_457"},"schema_458":{"kind":"json-schema","data":{"type":"object","properties":{"name":{"type":"string","description":"What the shift is called. Shown to people choosing shifts.","examples":[null]},"timezone":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The timezone the start and end times are given in, as an IANA name such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Australia/Melbourne"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"min_demand":{"type":"integer","description":"The fewest people the shift needs. Defaults to 1.","examples":[1]},"max_demand":{"type":"integer","description":"The most people the shift can take. Applications are refused once it is full.","examples":[1]},"leader_demand":{"type":"integer","description":"How many of those places are for leaders. Defaults to 0.","examples":[1]},"start_timestamp":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the shift starts, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD HH:MM:SS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the shift's timezone."},"children":[]}]}]}],"examples":[null]},"end_timestamp":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the shift ends, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD HH:MM:SS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the shift's timezone."},"children":[]}]}]}],"examples":[null]},"is_virtual":{"type":"boolean","description":"Whether the shift happens online rather than at a place.","examples":[true]},"event_shift_type_id":{"type":"integer","description":"The shift type, which groups shifts for reporting and for the per-type application limits an event can set.","examples":[1]},"shift_status_default":{"type":"integer","description":"The status a new application on this shift starts at.","examples":[1]},"shift_confirmed_status_default":{"type":"integer","description":"The status an application moves to when it is confirmed.","examples":[1]},"shift_rejected_status_default":{"type":"integer","description":"The status an application moves to when it is rejected.","examples":[1]},"shift_can_withdraw_default":{"type":"boolean","description":"Whether people can withdraw from the shift themselves.","examples":[true]},"shift_can_withdraw_limit":{"type":"integer","description":"How long before the shift starts withdrawing stops being allowed, in seconds.","examples":[1]},"shift_can_confirm":{"type":"boolean","description":"Whether people can confirm their own place on the shift.","examples":[true]},"shift_can_confirm_limit":{"type":"integer","description":"How long before the shift starts confirming stops being allowed, in seconds.","examples":[1]},"shift_checked_in_status_default":{"type":"integer","description":"The status an assignment moves to on check-in.","examples":[1]},"shift_checked_out_status_default":{"type":"integer","description":"The status an assignment moves to on check-out.","examples":[1]},"address":{"type":"object","description":"Where the shift happens, as an address object. Required on a create unless the shift is virtual or takes its location from a venue.","properties":{},"examples":["{}"]},"headcount_location_venue_id":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The venue the shift happens at. Sending one takes the location from the venue instead of from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"address"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[1]},"certificate_id":{"type":"integer","description":"A certificate awarded for attending the shift.","examples":[1]},"shift_application_form_id":{"type":"integer","description":"The form someone fills in when applying for this shift.","examples":[1]},"allow_application_form_resubmit":{"type":"boolean","description":"Whether someone can submit the application form again.","examples":[true]},"shift_precheckin_form_id":{"type":"integer","description":"The form filled in at pre-check-in.","examples":[1]},"shift_checkin_form_id":{"type":"integer","description":"The form filled in at check-in.","examples":[1]},"shift_attended_form_id":{"type":"integer","description":"The form filled in once the shift has been attended.","examples":[1]},"shift_checkout_form_id":{"type":"integer","description":"The form filled in at check-out.","examples":[1]},"shift_withdraw_form_id":{"type":"integer","description":"The form filled in when withdrawing.","examples":[1]},"visibility_show_groups":{"type":"array","description":"Only members of these groups can see the shift.","items":{"type":"integer"},"examples":[[]]},"visibility_hide_groups":{"type":"array","description":"Members of these groups cannot see the shift.","items":{"type":"integer"},"examples":[[]]},"visibility_show_roleoffer":{"type":"array","description":"Only people holding one of these role offers can see the shift.","items":{"type":"integer"},"examples":[[]]},"apps_open_timestamp":{"type":"string","description":"When applications open. Before this, applying is refused.","examples":[null]},"apps_close_timestamp":{"type":"string","description":"When applications close. After this, applying is refused.","examples":[null]},"role_offer_id":{"type":"integer","description":"The role offer this shift belongs to.","examples":[1]},"role_offer_address":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Take the shift's location from the role offer rather than from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"address"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[true]},"shift_precheckin_open":{"type":"integer","description":"How long before the shift starts pre-check-in opens, in seconds.","examples":[1]},"max_group_demand":{"type":"integer","description":"How many places a single group booking can take.","examples":[1]},"group_booking_ttl":{"type":"integer","description":"How long a group booking is held before it lapses, in seconds.","examples":[1]},"max_group_size":{"type":"integer","description":"The largest group that can book onto the shift.","examples":[1]},"reserved_expiry":{"type":"integer","description":"How long a reserved place is held before it lapses, in seconds.","examples":[1]},"self_checkin":{"type":"boolean","description":"Whether people can check themselves in to the shift.","examples":[true]},"self_checkin_open":{"type":"integer","description":"How long before the shift starts self check-in opens, in seconds.","examples":[1]},"self_checkin_close":{"type":"integer","description":"How long after the shift starts self check-in closes, in seconds.","examples":[1]},"self_checkout_close":{"type":"integer","description":"How long after the shift ends self check-out closes, in seconds.","examples":[1]},"checkin_close":{"type":"integer","description":"How long after the shift ends check-in closes, in seconds.","examples":[1]},"geofence_checkin_limit":{"type":"integer","description":"How close to the shift's location someone has to be to check in, in metres.","examples":[1]},"checkin_visible_attributes":{"type":"array","description":"Which of a person's attributes are shown on the check-in screen.","items":{"type":"integer"},"examples":[[]]},"training_ids":{"type":"array","description":"Training people must have completed before they can be placed on the shift.","items":{"type":"integer"},"examples":[[]]},"post_feedback_form":{"type":"integer","description":"The form people fill in about the shift afterwards.","examples":[1]},"shift_leader_feedback_form_id":{"type":"integer","description":"The form a leader fills in about the shift.","examples":[1]},"shift_enable_waitlist_default":{"type":"boolean","description":"Whether people can join a waitlist once the shift is full.","examples":[true]},"max_waitlist":{"type":"integer","description":"How many people the waitlist holds.","examples":[1]},"publish":{"type":"boolean","description":"Whether the shift is visible to people who can apply for it. Ignored from a caller who cannot publish shifts.","examples":[true]},"public":{"type":"boolean","description":"Whether the shift can be seen without signing in, on a public event.","examples":[true]},"is_cancelled":{"type":"boolean","description":"Whether the shift is cancelled. Cancelling this way does not move anyone already on the shift; use the cancel endpoint for that.","examples":[true]},"sort_order":{"type":"integer","description":"Where the shift sits when shifts are shown in a fixed order.","examples":[1]},"minimum_dob":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Latest date of birth allowed on the shift. Cannot be sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"minimum_age"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"minimum_age":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Youngest age allowed on the shift, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"years:months"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"maximum_dob":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Earliest date of birth allowed on the shift. Cannot be sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"maximum_age"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"maximum_age":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Oldest age allowed on the shift, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"years:months"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[null]},"price_excluding_tax":{"type":"number","description":"What taking this shift costs the person, before tax.","examples":[1.23]},"tax_percentage":{"type":"integer","description":"Tax charged on the price, as a percentage between 0 and 100.","examples":[1]},"cost_description":{"type":"string","description":"Free text shown alongside the price.","examples":[null]},"custom_*":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A custom attribute, named by its code - custom_shirt_size, for example. The value follows the attribute's own type, so it may be a string, a number, a boolean or a list. See the custom attributes documentation."},"children":[]}]}]}],"examples":[null]}}},"id":"schema_458"},"schema_459":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[2001]},"event_id":{"type":"integer","examples":[1001]},"event_shift_type_id":{"type":["string","null"],"examples":[null]},"event_shift_template_id":{"type":["string","null"],"examples":[null]},"journey_id":{"type":["string","null"],"examples":[null]},"min_demand":{"type":"integer","examples":[2]},"max_demand":{"type":"integer","examples":[10]},"leader_demand":{"type":"integer","examples":[1]},"start_timestamp":{"type":"string","examples":["2026-09-17 05:00:00"]},"end_timestamp":{"type":"string","examples":["2026-09-17 13:00:00"]},"timezone":{"type":"string","examples":["Australia/Melbourne"]},"no_shift_time":{"type":"integer","examples":[0]},"apps_open_timestamp":{"type":["string","null"],"examples":[null]},"apps_close_timestamp":{"type":["string","null"],"examples":[null]},"headcount_location_venue_id":{"type":["string","null"],"examples":[null]},"shift_status_default":{"type":"integer","examples":[1]},"shift_confirmed_status_default":{"type":"integer","examples":[3]},"shift_rejected_status_default":{"type":"integer","examples":[6]},"journey_complete_status":{"type":["string","null"],"examples":[null]},"shift_can_withdraw_default":{"type":"integer","examples":[1]},"shift_can_confirm":{"type":"integer","examples":[1]},"shift_can_confirm_limit":{"type":"integer","examples":[0]},"shift_can_withdraw_limit":{"type":"integer","examples":[0]},"shift_checked_in_status_default":{"type":"integer","examples":[4]},"shift_checked_out_status_default":{"type":"integer","examples":[4]},"certificate_id":{"type":["string","null"],"examples":[null]},"shift_application_form_id":{"type":["string","null"],"examples":[null]},"allow_application_form_resubmit":{"type":"integer","examples":[0]},"shift_checkin_form_id":{"type":["string","null"],"examples":[null]},"shift_attended_form_id":{"type":["string","null"],"examples":[null]},"shift_checkout_form_id":{"type":["string","null"],"examples":[null]},"shift_precheckin_form_id":{"type":["string","null"],"examples":[null]},"shift_withdraw_form_id":{"type":["string","null"],"examples":[null]},"training_ids":{"type":["string","null"],"examples":[null]},"visibility_show_groups":{"type":"array","examples":[[]]},"visibility_hide_groups":{"type":"array","examples":[[]]},"visibility_show_roleoffer":{"type":"array","examples":[[]]},"role_offer_id":{"type":["string","null"],"examples":[null]},"role_offer_address":{"type":"integer","examples":[0]},"checkin_visible_attributes":{"type":"array","examples":[[]]},"shift_enable_waitlist_default":{"type":"integer","examples":[0]},"max_waitlist":{"type":"integer","examples":[0]},"group_booking_ttl":{"type":["string","null"],"examples":[null]},"max_group_demand":{"type":["string","null"],"examples":[null]},"max_group_size":{"type":["string","null"],"examples":[null]},"reserved_expiry":{"type":["string","null"],"examples":[null]},"minimum_dob":{"type":["string","null"],"examples":[null]},"minimum_age":{"type":["string","null"],"examples":[null]},"maximum_dob":{"type":["string","null"],"examples":[null]},"maximum_age":{"type":["string","null"],"examples":[null]},"self_checkin":{"type":"integer","examples":[0]},"self_checkin_open":{"type":"integer","examples":[1800]},"self_checkin_close":{"type":"integer","examples":[1800]},"self_checkout_close":{"type":"integer","examples":[1800]},"checkin_close":{"type":"integer","examples":[0]},"shift_precheckin_open":{"type":"integer","examples":[0]},"break":{"type":"integer","examples":[0]},"post_feedback_form":{"type":["string","null"],"examples":[null]},"shift_leader_feedback_form_id":{"type":["string","null"],"examples":[null]},"is_virtual":{"type":"integer","examples":[0]},"geofence_checkin_limit":{"type":["string","null"],"examples":[null]},"tax":{"type":["string","null"],"examples":[null]},"price_excluding_tax":{"type":"integer","examples":[0]},"tax_percentage":{"type":["string","null"],"examples":[null]},"publish":{"type":"integer","examples":[0]},"public":{"type":"integer","examples":[0]},"sort_order":{"type":"integer","examples":[0]},"is_cancelled":{"type":"integer","examples":[0]},"deleted_at":{"type":["string","null"],"examples":[null]},"is_erased":{"type":"integer","examples":[0]},"is_draft":{"type":"boolean","examples":[false]},"created_at":{"type":"string","examples":["2026-06-09T05:36:11.000000Z"]},"updated_at":{"type":"string","examples":["2026-08-12T05:00:00.000000Z"]},"deleted_by":{"type":["string","null"],"examples":[null]},"cost_description":{"type":["string","null"],"examples":[null]},"event_shift_description":{"type":"string","examples":[""]},"name":{"type":["string","null"],"examples":[null]},"address":{"type":"object","properties":{"iso":{"type":"string","examples":["AUS"]},"region_code":{"type":"string","examples":["VIC"]},"coordinates":{"type":"object","properties":{"latitude":{"type":"string","examples":["-37.814000"]},"longitude":{"type":"string","examples":["144.963100"]}}},"street_address_1":{"type":"string","examples":["1 Example Street"]},"street_address_2":{"type":["string","null"],"examples":[null]},"street_address_3":{"type":["string","null"],"examples":[null]},"city":{"type":"string","examples":["Melbourne"]},"postcode":{"type":"string","examples":["3000"]},"region":{"type":"string","examples":["VIC"]},"country":{"type":"string","examples":["AU"]},"latitude":{"type":"string","examples":["-37.814000"]},"longitude":{"type":"string","examples":["144.963100"]}}}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:example:20000:shift:2001"]},"address":{"type":"string","examples":["1 Example Street\nMelbourne\nVictoria\nAustralia\n3000"]},"address_oneline":{"type":"string","examples":["1 Example Street, Melbourne, Victoria, Australia, 3000"]},"address.country":{"type":"string","examples":["Australia"]},"address.country:raw":{"type":"string","examples":["AUS"]},"address.city":{"type":"string","examples":["Melbourne"]},"address.region":{"type":"string","examples":["Victoria"]},"address.region:raw":{"type":"string","examples":["VIC"]},"address.postcode":{"type":"string","examples":["3000"]},"address.street_address_1":{"type":"string","examples":["1 Example Street"]},"address.street_address_2":{"type":"string","examples":[""]},"address.street_address_3":{"type":"string","examples":[""]},"address.latitude":{"type":"string","examples":["-37.814000"]},"address.longitude":{"type":"string","examples":["144.963100"]},"created_at":{"type":"string","examples":["Jun 9, 2026, 3:36 PM"]},"created_at__date":{"type":"string","examples":["Jun 9, 2026"]},"created_at__time":{"type":"string","examples":["3:36 PM"]},"created_at__offset":{"type":"string","examples":[" (+10:00 AEST)"]},"created_at__offset_minutes":{"type":"integer","examples":[600]},"created_at__dayofweek":{"type":"string","examples":["Tuesday"]},"end_timestamp":{"type":"string","examples":["Sep 17, 2026, 11:00 PM"]},"end_timestamp__date":{"type":"string","examples":["Sep 17, 2026"]},"end_timestamp__time":{"type":"string","examples":["11:00 PM"]},"end_timestamp__offset":{"type":"string","examples":[" (+10:00 AEST)"]},"end_timestamp__offset_minutes":{"type":"integer","examples":[600]},"end_timestamp__dayofweek":{"type":"string","examples":["Thursday"]},"event_shift_template_id":{"type":["string","null"],"examples":[null]},"event_shift_template_id:value":{"type":["string","null"],"examples":[null]},"event_shift_template_id:array":{"type":["string","null"],"examples":[null]},"event_shift_type_id":{"type":["string","null"],"examples":[null]},"event_shift_type_id:value":{"type":["string","null"],"examples":[null]},"event_shift_type_id:array":{"type":["string","null"],"examples":[null]},"headcount_location_venue_id":{"type":["string","null"],"examples":[null]},"headcount_location_venue_id:value":{"type":["string","null"],"examples":[null]},"headcount_location_venue_id:array":{"type":["string","null"],"examples":[null]},"is_virtual":{"type":"string","examples":["No"]},"minimum_age":{"type":"string","examples":[""]},"name":{"type":"string","examples":[""]},"no_shift_time":{"type":"string","examples":["No"]},"post_feedback_form":{"type":["string","null"],"examples":[null]},"post_feedback_form:value":{"type":["string","null"],"examples":[null]},"post_feedback_form:array":{"type":["string","null"],"examples":[null]},"public":{"type":"string","examples":["No"]},"publish":{"type":"string","examples":["No"]},"role_offer_address":{"type":"string","examples":["No"]},"role_offer_id":{"type":["string","null"],"examples":[null]},"role_offer_id:value":{"type":["string","null"],"examples":[null]},"role_offer_id:array":{"type":["string","null"],"examples":[null]},"self_checkin":{"type":"string","examples":["No"]},"shift_application_form_id":{"type":["string","null"],"examples":[null]},"shift_application_form_id:value":{"type":["string","null"],"examples":[null]},"shift_application_form_id:array":{"type":["string","null"],"examples":[null]},"shift_attended_form_id":{"type":["string","null"],"examples":[null]},"shift_attended_form_id:value":{"type":["string","null"],"examples":[null]},"shift_attended_form_id:array":{"type":["string","null"],"examples":[null]},"shift_checkin_form_id":{"type":["string","null"],"examples":[null]},"shift_checkin_form_id:value":{"type":["string","null"],"examples":[null]},"shift_checkin_form_id:array":{"type":["string","null"],"examples":[null]},"shift_checkout_form_id":{"type":["string","null"],"examples":[null]},"shift_checkout_form_id:value":{"type":["string","null"],"examples":[null]},"shift_checkout_form_id:array":{"type":["string","null"],"examples":[null]},"shift_precheckin_form_id":{"type":["string","null"],"examples":[null]},"shift_precheckin_form_id:value":{"type":["string","null"],"examples":[null]},"shift_precheckin_form_id:array":{"type":["string","null"],"examples":[null]},"shift_withdraw_form_id":{"type":["string","null"],"examples":[null]},"shift_withdraw_form_id:value":{"type":["string","null"],"examples":[null]},"shift_withdraw_form_id:array":{"type":["string","null"],"examples":[null]},"start_timestamp":{"type":"string","examples":["Sep 17, 2026, 3:00 PM"]},"start_timestamp__date":{"type":"string","examples":["Sep 17, 2026"]},"start_timestamp__time":{"type":"string","examples":["3:00 PM"]},"start_timestamp__offset":{"type":"string","examples":[" (+10:00 AEST)"]},"start_timestamp__offset_minutes":{"type":"integer","examples":[600]},"start_timestamp__dayofweek":{"type":"string","examples":["Thursday"]},"updated_at":{"type":"string","examples":["Aug 12, 2026, 3:00 PM"]},"updated_at__date":{"type":"string","examples":["Aug 12, 2026"]},"updated_at__time":{"type":"string","examples":["3:00 PM"]},"updated_at__offset":{"type":"string","examples":[" (+10:00 AEST)"]},"updated_at__offset_minutes":{"type":"integer","examples":[600]},"updated_at__dayofweek":{"type":"string","examples":["Wednesday"]},"visibility_hide_groups":{"type":"string","examples":[""]},"visibility_show_groups":{"type":"string","examples":[""]},"visibility_show_roleoffer":{"type":"string","examples":[""]},"info":{"type":"string","examples":[" - "]},"event_shift_link_id":{"type":["string","null"],"examples":[null]},"event_shift_link_repeat":{"type":"integer","examples":[0]},"event_shift_link_name":{"type":"string","examples":[""]},"shift_status_default_id":{"type":"integer","examples":[1]},"length":{"type":"integer","examples":[8]},"account_id":{"type":"integer","examples":[20000]},"account_url":{"type":"string","examples":["https://example.rosterfy.com/"]},"is_any_leader":{"type":"boolean","examples":[false]},"post_shift_feedback_form_completed_at":{"type":"string","examples":[""]},"pre_checkin_form_completed_at":{"type":"string","examples":[""]},"event_name":{"type":["string","null"],"examples":[null]}}},"relations":{"type":"object","properties":{}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]},"apply":{"type":"boolean","examples":[false]},"apply_error":{"type":"string","examples":["Shift applications not open"]},"apply_error_code":{"type":"string","examples":["ES0056"]},"is_unavailable":{"type":"boolean","examples":[false]},"confirm":{"type":"boolean","examples":[false]},"reject":{"type":"boolean","examples":[false]},"selfCheckin":{"type":"boolean","examples":[false]},"selfCheckout":{"type":"boolean","examples":[false]},"submitAttendedForm":{"type":"boolean","examples":[false]},"precheckin":{"type":"boolean","examples":[false]},"applyWaitlist":{"type":"boolean","examples":[false]}}},"attributes":{"type":"object","properties":{}}},"examples":[{"object":{"id":2001,"event_id":1001,"event_shift_type_id":null,"event_shift_template_id":null,"journey_id":null,"min_demand":2,"max_demand":10,"leader_demand":1,"start_timestamp":"2026-09-17 05:00:00","end_timestamp":"2026-09-17 13:00:00","timezone":"Australia/Melbourne","no_shift_time":0,"apps_open_timestamp":null,"apps_close_timestamp":null,"headcount_location_venue_id":null,"shift_status_default":1,"shift_confirmed_status_default":3,"shift_rejected_status_default":6,"journey_complete_status":null,"shift_can_withdraw_default":1,"shift_can_confirm":1,"shift_can_confirm_limit":0,"shift_can_withdraw_limit":0,"shift_checked_in_status_default":4,"shift_checked_out_status_default":4,"certificate_id":null,"shift_application_form_id":null,"allow_application_form_resubmit":0,"shift_checkin_form_id":null,"shift_attended_form_id":null,"shift_checkout_form_id":null,"shift_precheckin_form_id":null,"shift_withdraw_form_id":null,"training_ids":null,"visibility_show_groups":[],"visibility_hide_groups":[],"visibility_show_roleoffer":[],"role_offer_id":null,"role_offer_address":0,"checkin_visible_attributes":[],"shift_enable_waitlist_default":0,"max_waitlist":0,"group_booking_ttl":null,"max_group_demand":null,"max_group_size":null,"reserved_expiry":null,"minimum_dob":null,"minimum_age":null,"maximum_dob":null,"maximum_age":null,"self_checkin":0,"self_checkin_open":1800,"self_checkin_close":1800,"self_checkout_close":1800,"checkin_close":0,"shift_precheckin_open":0,"break":0,"post_feedback_form":null,"shift_leader_feedback_form_id":null,"is_virtual":0,"geofence_checkin_limit":null,"tax":null,"price_excluding_tax":0,"tax_percentage":null,"publish":0,"public":0,"sort_order":0,"is_cancelled":0,"deleted_at":null,"is_erased":0,"is_draft":false,"created_at":"2026-06-09T05:36:11.000000Z","updated_at":"2026-08-12T05:00:00.000000Z","deleted_by":null,"cost_description":null,"event_shift_description":"","name":null,"address":{"iso":"AUS","region_code":"VIC","coordinates":{"latitude":"-37.814000","longitude":"144.963100"},"street_address_1":"1 Example Street","street_address_2":null,"street_address_3":null,"city":"Melbourne","postcode":"3000","region":"VIC","country":"AU","latitude":"-37.814000","longitude":"144.963100"}},"nice":{"rrn":"rrn:example:20000:shift:2001","address":"1 Example Street\nMelbourne\nVictoria\nAustralia\n3000","address_oneline":"1 Example Street, Melbourne, Victoria, Australia, 3000","address.country":"Australia","address.country:raw":"AUS","address.city":"Melbourne","address.region":"Victoria","address.region:raw":"VIC","address.postcode":"3000","address.street_address_1":"1 Example Street","address.street_address_2":"","address.street_address_3":"","address.latitude":"-37.814000","address.longitude":"144.963100","created_at":"Jun 9, 2026, 3:36 PM","created_at__date":"Jun 9, 2026","created_at__time":"3:36 PM","created_at__offset":" (+10:00 AEST)","created_at__offset_minutes":600,"created_at__dayofweek":"Tuesday","end_timestamp":"Sep 17, 2026, 11:00 PM","end_timestamp__date":"Sep 17, 2026","end_timestamp__time":"11:00 PM","end_timestamp__offset":" (+10:00 AEST)","end_timestamp__offset_minutes":600,"end_timestamp__dayofweek":"Thursday","event_shift_template_id":null,"event_shift_template_id:value":null,"event_shift_template_id:array":null,"event_shift_type_id":null,"event_shift_type_id:value":null,"event_shift_type_id:array":null,"headcount_location_venue_id":null,"headcount_location_venue_id:value":null,"headcount_location_venue_id:array":null,"is_virtual":"No","minimum_age":"","name":"","no_shift_time":"No","post_feedback_form":null,"post_feedback_form:value":null,"post_feedback_form:array":null,"public":"No","publish":"No","role_offer_address":"No","role_offer_id":null,"role_offer_id:value":null,"role_offer_id:array":null,"self_checkin":"No","shift_application_form_id":null,"shift_application_form_id:value":null,"shift_application_form_id:array":null,"shift_attended_form_id":null,"shift_attended_form_id:value":null,"shift_attended_form_id:array":null,"shift_checkin_form_id":null,"shift_checkin_form_id:value":null,"shift_checkin_form_id:array":null,"shift_checkout_form_id":null,"shift_checkout_form_id:value":null,"shift_checkout_form_id:array":null,"shift_precheckin_form_id":null,"shift_precheckin_form_id:value":null,"shift_precheckin_form_id:array":null,"shift_withdraw_form_id":null,"shift_withdraw_form_id:value":null,"shift_withdraw_form_id:array":null,"start_timestamp":"Sep 17, 2026, 3:00 PM","start_timestamp__date":"Sep 17, 2026","start_timestamp__time":"3:00 PM","start_timestamp__offset":" (+10:00 AEST)","start_timestamp__offset_minutes":600,"start_timestamp__dayofweek":"Thursday","updated_at":"Aug 12, 2026, 3:00 PM","updated_at__date":"Aug 12, 2026","updated_at__time":"3:00 PM","updated_at__offset":" (+10:00 AEST)","updated_at__offset_minutes":600,"updated_at__dayofweek":"Wednesday","visibility_hide_groups":"","visibility_show_groups":"","visibility_show_roleoffer":"","info":" - ","event_shift_link_id":null,"event_shift_link_repeat":0,"event_shift_link_name":"","shift_status_default_id":1,"length":8,"account_id":20000,"account_url":"https://example.rosterfy.com/","is_any_leader":false,"post_shift_feedback_form_completed_at":"","pre_checkin_form_completed_at":"","event_name":null},"relations":{},"permissions":{"read":true,"update":true,"delete":true,"apply":false,"apply_error":"Shift applications not open","apply_error_code":"ES0056","is_unavailable":false,"confirm":false,"reject":false,"selfCheckin":false,"selfCheckout":false,"submitAttendedForm":false,"precheckin":false,"applyWaitlist":false},"attributes":{}}]},"id":"schema_459"},"schema_460":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","examples":["Do you want to also update the linked Shifts?"]},"reference":{"type":"string","examples":["_options.update_linked_shifts"]}},"examples":[{"message":"Do you want to also update the linked Shifts?","reference":"_options.update_linked_shifts"}]},"id":"schema_460"},"schema_461":{"kind":"json-schema","data":{"type":"object","properties":{"repeat":{"type":"boolean","description":"Also delete every later shift linked to this one. Only meaningful on a shift that belongs to a linked series, and required there - see the description.","examples":[true]}}},"id":"schema_461"},"schema_462":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","examples":["Do you want to delete all linked Shifts after this one?"]},"reference":{"type":"string","examples":["repeat"]}},"examples":[{"message":"Do you want to delete all linked Shifts after this one?","reference":"repeat"}]},"id":"schema_462"},"schema_463":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","examples":["There are 1 Users still scheduled onto this Shift"]},"reference":{"type":"string","examples":["override_system_limits.event.shift.delete.demand"]}},"examples":[{"message":"There are 1 Users still scheduled onto this Shift","reference":"override_system_limits.event.shift.delete.demand"}]},"id":"schema_463"},"schema_464":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"account_id":{"type":"integer","examples":[20101]},"user_id":{"type":"integer","examples":[1234]},"balance":{"type":"integer","examples":[1250]},"created_at":{"type":"string","examples":["2026-08-06T01:07:51.000000Z"]},"updated_at":{"type":"string","examples":["2026-08-06T01:07:51.000000Z"]},"deleted_at":{"type":["string","null"],"examples":[null]}}},"nice":{"type":"array","examples":[[]]},"relations":{"type":"object","properties":{}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[false]},"delete":{"type":"boolean","examples":[false]}}}},"examples":[{"object":{"id":1,"account_id":20101,"user_id":1234,"balance":1250,"created_at":"2026-08-06T01:07:51.000000Z","updated_at":"2026-08-06T01:07:51.000000Z","deleted_at":null},"nice":[],"relations":{},"permissions":{"read":true,"update":false,"delete":false}}]},"id":"schema_464"},"schema_465":{"kind":"json-schema","data":{"type":"object","properties":{"event_id":{"type":"integer","description":"The event whose shifts are to be filled. Required in practice - a request without it is accepted and then rosters nobody.","examples":[1]},"group_id":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user group to roster from. Required when source is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"group"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[1]},"headcount_functional_area_id":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Limits rostering to shifts in these functional areas. Applies when source is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"role_offer"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and specific_role is not set."},"children":[]}]}]}],"items":{"type":"integer"},"examples":[[]]},"role_offer_id":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The role offer whose accepted applicants are rostered. Used when source is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"role_offer"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Leave it out to roster each shift from whichever role offer that shift is already tied to."},"children":[]}]}]}],"examples":[1]},"specific_role":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with source "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"role_offer"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to roster only the role offer named in role_offer_id, rather than matching each shift to its own role offer."},"children":[]}]}]}],"examples":[true]},"event_shift_status_id":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The status each new shift application is created with, from the event_shift_status option set. This is what decides whether the people rostered are placed as confirmed, pending approval, or something else."},"children":[]}]}]}],"examples":[1]},"applyTo":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to fill only the shifts named in selected. Any other value fills every shift on the event that the caller can see, narrowed by filter if one is sent."},"children":[]}]}]}],"examples":[null]},"selected":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The IDs of the shifts to fill. Read when applyTo is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and ignored otherwise."},"children":[]}]}]}],"items":{"type":"integer"},"examples":[[]]},"bypass_scheduled":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to skip anyone already rostered onto the shifts in scope, so a repeated request does not consider them again."},"children":[]}]}]}],"examples":[true]},"source":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Where the people come from: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"group"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to use a user group, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"role_offer"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to use the accepted applicants of a role offer, or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"import"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to upload a file of them. Any other value is accepted and rosters nobody."},"children":[]}]}]}],"examples":[null]},"filter":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Narrows which of the event's shifts are filled, in the same form the shift listing accepts. Read only when applyTo is not "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"selected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"items":{"type":"object"},"examples":[[]]},"file":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The file of people to roster, as a multipart upload. Required when source is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"import"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", rejected as an unsupported format otherwise. Accepts the same spreadsheet and CSV formats as an import."},"children":[]}]}]}],"examples":[null]}},"required":["event_id","event_shift_status_id","applyTo","source"]},"id":"schema_465"},"schema_466":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","examples":["Mass operation succeeded"]}},"examples":[{"message":"Mass operation succeeded"}]},"id":"schema_466"},"schema_467":{"kind":"json-schema","data":{"type":"string","examples":["event_shift_status"]},"id":"schema_467"},"schema_468":{"kind":"json-schema","data":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to keep any extra keys an option set carries beyond value"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and text, such as the group a shift status belongs to. Defaults to 1, which returns value"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and text only."},"children":[]}]}]}],"examples":[0]},"id":"schema_468"},"schema_469":{"kind":"json-schema","data":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to limit the list to options that are currently in use."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Not every option set distinguishes active options, and those that do not return the full"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"list either way."},"children":[]}]}]}],"examples":[1]},"id":"schema_469"},"schema_470":{"kind":"json-schema","data":{"type":"array","description":"Narrows the list, in the same form the listing endpoints accept.\n  Only option sets backed by a record type support it; the rest ignore it.","items":{"type":"object"},"examples":[null]},"id":"schema_470"},"schema_471":{"kind":"json-schema","data":{"type":"array","items":{"type":"object","properties":{"value":{"type":"integer","examples":[1]},"text":{"type":"string","examples":["Applied"]}}},"examples":[[{"value":1,"text":"Applied"},{"value":2,"text":"Pending"},{"value":3,"text":"Confirmed"},{"value":4,"text":"Attended"},{"value":5,"text":"Emergency"},{"value":6,"text":"Rejected"},{"value":7,"text":"Waitlist"},{"value":8,"text":"Cancelled"},{"value":9,"text":"Conflict"},{"value":10,"text":"No Show"},{"value":11,"text":"Checked In"},{"value":12,"text":"Not Approved"},{"value":13,"text":"Expired"}]]},"id":"schema_471"},"schema_472":{"kind":"json-schema","data":{"type":"boolean","description":"Return only forms whose submissions are\n  collected from the people filling them in, excluding admin submission forms.","examples":[true]},"id":"schema_472"},"schema_473":{"kind":"json-schema","data":{"type":"boolean","description":"Return only admin submission\n  forms - the ones an administrator completes about somebody else.","examples":[true]},"id":"schema_473"},"schema_474":{"kind":"json-schema","data":{"type":"integer","description":"Narrow the result to the forms a report of this\n  type can be built from.","examples":[3]},"id":"schema_474"},"schema_475":{"kind":"json-schema","data":{"type":"array","items":{"type":"object","properties":{"current_page":{"type":"integer","examples":[1]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[37]},"form_type_id":{"type":"integer","examples":[15]},"name":{"type":"string","examples":["Volunteer Application"]},"form_title":{"type":"string","examples":["Volunteer Application"]},"form_category_id":{"type":["string","null"],"examples":[null]},"success_content":{"type":"string","examples":[""]},"close_content":{"type":"string","examples":[""]},"options":{"type":"array","examples":[[]]},"rules":{"type":"array","examples":[[]]},"cost":{"type":"string","examples":["0.00"]},"tax_percentage":{"type":"string","examples":["0.00"]},"close_at":{"type":["string","null"],"examples":[null]},"public":{"type":"integer","examples":[0]},"is_archived":{"type":"integer","examples":[0]},"token":{"type":"string","examples":["xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-06-09T05:36:25.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:25.000000Z"]},"deleted_by":{"type":["string","null"],"examples":[null]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:form:37"]},"is_open":{"type":"string","examples":["Yes"]},"close_at":{"type":["string","null"],"examples":[null]},"is_foreign_account":{"type":"boolean","examples":[false]}}},"relations":{"type":"object","properties":{"form_type":{"type":"object","properties":{"id":{"type":"integer","examples":[15]},"name":{"type":"string","examples":["User Interaction - New answers for new submissions"]},"code":{"type":"string","examples":["user_submission"]},"main_entity":{"type":"string","examples":["user_form_submission"]},"entities":{"type":"object","properties":{"user_form_submission":{"type":"object","properties":{"create":{"type":"boolean","examples":[true]}}}}},"public_field":{"type":"object","properties":{"form_title":{"type":"object","properties":{"rules":{"type":"string","examples":["required|json"]},"validation":{"type":"string","examples":["required"]}}},"close_content":{"type":"object","properties":{"rules":{"type":"string","examples":["nullable|json"]},"validation":{"type":"string","examples":["string"]}}},"success_content":{"type":"object","properties":{"rules":{"type":"string","examples":["required|json"]},"validation":{"type":"string","examples":["required"]}}}}},"access":{"type":"string","examples":["form"]}}}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[false]},"copy":{"type":"boolean","examples":[false]}}}}},"examples":[[{"object":{"id":37,"form_type_id":15,"name":"Volunteer Application","form_title":"Volunteer Application","form_category_id":null,"success_content":"","close_content":"","options":[],"rules":[],"cost":"0.00","tax_percentage":"0.00","close_at":null,"public":0,"is_archived":0,"token":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","deleted_at":null,"created_at":"2026-06-09T05:36:25.000000Z","updated_at":"2026-06-09T05:36:25.000000Z","deleted_by":null},"nice":{"rrn":"rrn:local:20101:form:37","is_open":"Yes","close_at":null,"is_foreign_account":false},"relations":{"form_type":{"id":15,"name":"User Interaction - New answers for new submissions","code":"user_submission","main_entity":"user_form_submission","entities":{"user_form_submission":{"create":true}},"public_field":{"form_title":{"rules":"required|json","validation":"required"},"close_content":{"rules":"nullable|json","validation":"string"},"success_content":{"rules":"required|json","validation":"required"}},"access":"form"}},"permissions":{"read":true,"update":true,"delete":false,"copy":false}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}]]},"first_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/form?per_page=5&_locale=en-US&page=1"]},"from":{"type":"integer","examples":[1]},"next_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/form?per_page=5&_locale=en-US&page=2"]},"path":{"type":"string","examples":["https://example.rosterfy.com/api/v2/form"]},"per_page":{"type":"integer","examples":[5]},"prev_page_url":{"type":["string","null"],"examples":[null]},"to":{"type":"integer","examples":[5]}}},"examples":[[{"current_page":1,"data":[{"object":{"id":37,"form_type_id":15,"name":"Volunteer Application","form_title":"Volunteer Application","form_category_id":null,"success_content":"","close_content":"","options":[],"rules":[],"cost":"0.00","tax_percentage":"0.00","close_at":null,"public":0,"is_archived":0,"token":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","deleted_at":null,"created_at":"2026-06-09T05:36:25.000000Z","updated_at":"2026-06-09T05:36:25.000000Z","deleted_by":null},"nice":{"rrn":"rrn:local:20101:form:37","is_open":"Yes","close_at":null,"is_foreign_account":false},"relations":{"form_type":{"id":15,"name":"User Interaction - New answers for new submissions","code":"user_submission","main_entity":"user_form_submission","entities":{"user_form_submission":{"create":true}},"public_field":{"form_title":{"rules":"required|json","validation":"required"},"close_content":{"rules":"nullable|json","validation":"string"},"success_content":{"rules":"required|json","validation":"required"}},"access":"form"}},"permissions":{"read":true,"update":true,"delete":false,"copy":false}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}],"first_page_url":"https://example.rosterfy.com/api/v2/form?per_page=5&_locale=en-US&page=1","from":1,"next_page_url":"https://example.rosterfy.com/api/v2/form?per_page=5&_locale=en-US&page=2","path":"https://example.rosterfy.com/api/v2/form","per_page":5,"prev_page_url":null,"to":5}]]},"id":"schema_475"},"schema_476":{"kind":"json-schema","data":{"type":"object","properties":{"_options":{"type":"object","description":"Create-time options that are not stored on the form.","properties":{"from_template":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The id of a form template to build this"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"form from. The template supplies the name and the form type, so neither has to"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"be sent; a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" you do send is kept."},"children":[]}]}]}],"examples":[8]}},"examples":[[]]},"name":{"type":"string","description":"The name administrators see for this form in the admin console. Not shown to the people filling it in.","examples":["Volunteer Application"]},"form_type_id":{"type":"integer","description":"What the form is for, and therefore what submitting it creates - a user registration, a standalone submission, an update to a user, and so on. Cannot be changed once the form exists. Read the available types from the form type resource.","examples":[15]},"form_title":{"type":"string","description":"The title shown at the top of the form to the people filling it in. May be sent as a plain string, or as an object keyed by locale code to give each language its own title.","examples":["Volunteer Application"]},"success_content":{"type":"string","description":"HTML shown after the form is submitted successfully. Accepts a locale-keyed object in the same way as the title.","examples":[""]},"close_content":{"type":"string","description":"HTML shown in place of the form once it has closed. Accepts a locale-keyed object in the same way as the title.","examples":[""]},"form_category_id":{"type":"integer","description":"The category the form is filed under in the admin console.","examples":[1]},"options":{"type":"object","description":"Form-wide settings. The keys available depend on the form type; send the object back as you read it, changing only what you mean to change.","properties":{},"examples":[[]]},"rules":{"type":"object","description":"Visibility rules deciding which fields are shown, keyed by field. Sending an invalid rule set is rejected rather than partially applied.","properties":{},"examples":[[]]},"public":{"type":"boolean","description":"Whether the form may be opened without signing in. Only takes effect on anonymous forms; every other type still requires a signed-in caller.","examples":[0]},"is_archived":{"type":"boolean","description":"Whether the form is archived. Archived forms stay readable but are filtered out of the admin console listings.","examples":[0]}},"required":["name","form_type_id"]},"id":"schema_476"},"schema_477":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"options":{"type":"array","examples":[[]]},"rules":{"type":"array","examples":[[]]},"name":{"type":"string","examples":["Volunteer Application"]},"form_type_id":{"type":"integer","examples":[15]},"token":{"type":"string","examples":["xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"]},"updated_at":{"type":"string","examples":["2026-08-17T04:58:45.000000Z"]},"created_at":{"type":"string","examples":["2026-08-17T04:58:45.000000Z"]},"id":{"type":"integer","examples":[47]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:form:47"]},"is_open":{"type":"string","examples":["Yes"]},"close_at":{"type":["string","null"],"examples":[null]},"is_foreign_account":{"type":"boolean","examples":[false]}}},"relations":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[true]},"copy":{"type":"boolean","examples":[false]}}}},"examples":[{"object":{"options":[],"rules":[],"name":"Volunteer Application","form_type_id":15,"token":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","updated_at":"2026-08-17T04:58:45.000000Z","created_at":"2026-08-17T04:58:45.000000Z","id":47},"nice":{"rrn":"rrn:local:20101:form:47","is_open":"Yes","close_at":null,"is_foreign_account":false},"relations":[],"permissions":{"read":true,"update":true,"delete":true,"copy":false}}]},"id":"schema_477"},"schema_478":{"kind":"json-schema","data":{"type":"object","properties":{"close_form":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether the form should close automatically. Send it"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"close_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; without it the closing time is cleared."},"children":[]}]}]}],"examples":[true]},"name":{"type":"string","description":"The name administrators see for this form in the admin console. Not shown to the people filling it in.","examples":["Volunteer Application"]},"form_title":{"type":"string","description":"The title shown at the top of the form to the people filling it in. May be sent as a plain string, or as an object keyed by locale code to give each language its own title.","examples":["Volunteer Application"]},"success_content":{"type":"string","description":"HTML shown after the form is submitted successfully. Accepts a locale-keyed object in the same way as the title.","examples":[""]},"options":{"type":"object","description":"Form-wide settings. The keys available depend on the form type; send the object back as you read it, changing only what you mean to change.","properties":{},"examples":[[]]},"rules":{"type":"object","description":"Visibility rules deciding which fields are shown, keyed by field. Sending an invalid rule set is rejected rather than partially applied.","properties":{},"examples":[[]]},"public":{"type":"boolean","description":"Whether the form may be opened without signing in. Only takes effect on anonymous forms; every other type still requires a signed-in caller.","examples":[0]},"is_archived":{"type":"boolean","description":"Whether the form is archived. Archived forms stay readable but are filtered out of the admin console listings.","examples":[0]},"close_content":{"type":"string","description":"HTML shown in place of the form once it has closed. Accepts a locale-keyed object in the same way as the title.","examples":[""]},"form_category_id":{"type":"integer","description":"The category the form is filed under in the admin console.","examples":[1]},"close_at":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the form stops accepting submissions, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD HH:MM:SS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Only honoured when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"close_form"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is sent with it; without that the value is cleared."},"children":[]}]}]}],"examples":[null]},"cost":{"type":"number","description":"What submitting the form costs, for the form types that take a payment.","examples":["0.00"]},"tax_percentage":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Tax applied to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cost"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", as a percentage between 0 and 100."},"children":[]}]}]}],"examples":["0.00"]}}},"id":"schema_478"},"schema_479":{"kind":"json-schema","data":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[37]},"form_type_id":{"type":"integer","examples":[15]},"name":{"type":"string","examples":["Volunteer Application"]},"form_title":{"type":"string","examples":["Volunteer Application"]},"form_category_id":{"type":["string","null"],"examples":[null]},"success_content":{"type":"string","examples":[""]},"close_content":{"type":"string","examples":[""]},"options":{"type":"array","examples":[[]]},"rules":{"type":"array","examples":[[]]},"cost":{"type":"string","examples":["0.00"]},"tax_percentage":{"type":"string","examples":["0.00"]},"close_at":{"type":["string","null"],"examples":[null]},"public":{"type":"integer","examples":[0]},"is_archived":{"type":"integer","examples":[0]},"token":{"type":"string","examples":["xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-06-09T05:36:25.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:25.000000Z"]},"deleted_by":{"type":["string","null"],"examples":[null]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:form:37"]},"is_open":{"type":"string","examples":["Yes"]},"close_at":{"type":["string","null"],"examples":[null]},"is_foreign_account":{"type":"boolean","examples":[false]}}},"relations":{"type":"object","properties":{"form_type":{"type":"object","properties":{"id":{"type":"integer","examples":[15]},"name":{"type":"string","examples":["User Interaction - New answers for new submissions"]},"code":{"type":"string","examples":["user_submission"]},"main_entity":{"type":"string","examples":["user_form_submission"]},"entities":{"type":"object","properties":{"user_form_submission":{"type":"object","properties":{"create":{"type":"boolean","examples":[true]}}}}},"public_field":{"type":"object","properties":{"form_title":{"type":"object","properties":{"rules":{"type":"string","examples":["required|json"]},"validation":{"type":"string","examples":["required"]}}},"close_content":{"type":"object","properties":{"rules":{"type":"string","examples":["nullable|json"]},"validation":{"type":"string","examples":["string"]}}},"success_content":{"type":"object","properties":{"rules":{"type":"string","examples":["required|json"]},"validation":{"type":"string","examples":["required"]}}}}},"access":{"type":"string","examples":["form"]}}}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[false]},"copy":{"type":"boolean","examples":[false]}}}},"examples":[{"object":{"id":37,"form_type_id":15,"name":"Volunteer Application","form_title":"Volunteer Application","form_category_id":null,"success_content":"","close_content":"","options":[],"rules":[],"cost":"0.00","tax_percentage":"0.00","close_at":null,"public":0,"is_archived":0,"token":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","deleted_at":null,"created_at":"2026-06-09T05:36:25.000000Z","updated_at":"2026-06-09T05:36:25.000000Z","deleted_by":null},"nice":{"rrn":"rrn:local:20101:form:37","is_open":"Yes","close_at":null,"is_foreign_account":false},"relations":{"form_type":{"id":15,"name":"User Interaction - New answers for new submissions","code":"user_submission","main_entity":"user_form_submission","entities":{"user_form_submission":{"create":true}},"public_field":{"form_title":{"rules":"required|json","validation":"required"},"close_content":{"rules":"nullable|json","validation":"string"},"success_content":{"rules":"required|json","validation":"required"}},"access":"form"}},"permissions":{"read":true,"update":true,"delete":false,"copy":false}}]},"id":"schema_479"},"schema_480":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","examples":["Cannot delete form - it is being used in an account setting."]}},"examples":[{"message":"Cannot delete form - it is being used in an account setting."}]},"id":"schema_480"},"schema_481":{"kind":"json-schema","data":{"type":"string","examples":["36"]},"id":"schema_481"},"schema_482":{"kind":"json-schema","data":{"type":"integer","description":"Fill the form in on behalf of this user.","examples":[23453473]},"id":"schema_482"},"schema_483":{"kind":"json-schema","data":{"type":"integer","description":"Reopen this existing submission. Must\n  belong to the form in the path.","examples":[2]},"id":"schema_483"},"schema_484":{"kind":"json-schema","data":{"type":"boolean","description":"Render a closed form anyway. Administrators only.","examples":[true]},"id":"schema_484"},"schema_485":{"kind":"json-schema","data":{"type":"string","description":"Render labels and content in this locale.","examples":["en"]},"id":"schema_485"},"schema_486":{"kind":"json-schema","data":{"type":"object","properties":{"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","examples":["user:custom_textarea_attribute"]},"type":{"type":"string","examples":["textarea"]},"required":{"type":"boolean","examples":[false]},"label":{"type":"string","examples":["custom textarea attribute"]}}},"examples":[[{"name":"user:custom_textarea_attribute","type":"textarea","required":false,"label":"custom textarea attribute"},{"name":"user:custom_text_attribute","type":"text","required":false,"label":"custom text attribute"},{"name":"user:custom_select_attribute","type":"select","required":false,"label":"custom select attribute","options":{"show_blank":true,"values":[{"value":63,"text":"AAAAAAAA","source_value":"aaaaaaaaaa"},{"value":64,"text":"Rigger","source_value":"user_select_item_1"},{"value":65,"text":"Physical Therapist Assistant","source_value":"user_select_item_2"},{"value":66,"text":"Gas Plant Operator","source_value":"user_select_item_3"},{"value":67,"text":"Forming Machine Operator","source_value":"user_select_item_4"},{"value":68,"text":"Credit Authorizer","source_value":"user_select_item_5"},{"value":69,"text":"Garment","source_value":"user_select_item_6"},{"value":70,"text":"Ship Engineer","source_value":"user_select_item_7"},{"value":71,"text":"Kindergarten Teacher","source_value":"user_select_item_8"},{"value":72,"text":"Photographic Process Worker","source_value":"user_select_item_9"},{"value":73,"text":"Decorator","source_value":"user_select_item_10"}]}},{"name":"user:custom_number_attribute","type":"number","required":false,"label":"custom number attribute","options":{"min":-999999.99,"max":999999.99,"step":"0.01"}},{"name":"user:custom_email_attribute","type":"email","required":false,"label":"custom email attribute"},{"name":"user:custom_boolean_attribute","type":"boolean","required":false,"label":"custom boolean attribute"}]]},"rrns":{"type":"object","properties":{"user":{"type":"string","examples":["rrn:local:20101:user:"]}}},"public":{"type":"integer","examples":[1]},"title":{"type":["string","null"],"examples":[null]},"success_content":{"type":"string","examples":[""]},"close_content":{"type":"string","examples":[""]},"values":{"type":"array","examples":[[]]},"recaptcha":{"type":"boolean","examples":[true]}},"examples":[{"fields":[{"name":"user:custom_textarea_attribute","type":"textarea","required":false,"label":"custom textarea attribute"},{"name":"user:custom_text_attribute","type":"text","required":false,"label":"custom text attribute"},{"name":"user:custom_select_attribute","type":"select","required":false,"label":"custom select attribute","options":{"show_blank":true,"values":[{"value":63,"text":"AAAAAAAA","source_value":"aaaaaaaaaa"},{"value":64,"text":"Rigger","source_value":"user_select_item_1"},{"value":65,"text":"Physical Therapist Assistant","source_value":"user_select_item_2"},{"value":66,"text":"Gas Plant Operator","source_value":"user_select_item_3"},{"value":67,"text":"Forming Machine Operator","source_value":"user_select_item_4"},{"value":68,"text":"Credit Authorizer","source_value":"user_select_item_5"},{"value":69,"text":"Garment","source_value":"user_select_item_6"},{"value":70,"text":"Ship Engineer","source_value":"user_select_item_7"},{"value":71,"text":"Kindergarten Teacher","source_value":"user_select_item_8"},{"value":72,"text":"Photographic Process Worker","source_value":"user_select_item_9"},{"value":73,"text":"Decorator","source_value":"user_select_item_10"}]}},{"name":"user:custom_number_attribute","type":"number","required":false,"label":"custom number attribute","options":{"min":-999999.99,"max":999999.99,"step":"0.01"}},{"name":"user:custom_email_attribute","type":"email","required":false,"label":"custom email attribute"},{"name":"user:custom_boolean_attribute","type":"boolean","required":false,"label":"custom boolean attribute"}],"rrns":{"user":"rrn:local:20101:user:"},"public":1,"title":null,"success_content":"","close_content":"","values":[],"recaptcha":true}]},"id":"schema_486"},"schema_487":{"kind":"json-schema","data":{"type":"string","examples":["37"]},"id":"schema_487"},"schema_488":{"kind":"json-schema","data":{"type":"object","properties":{"user:{field}":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A field value, keyed by the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" the render"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"response gives it. The set of fields differs per form."},"children":[]}]}]}],"examples":["Example answer"]},"recaptcha":{"type":"string","description":"A reCAPTCHA response. Required when submitting a public\n  form without signing in, and ignored otherwise.","examples":["03AGdBq26..."]}}},"id":"schema_488"},"schema_489":{"kind":"json-schema","data":{"oneOf":[{"description":"no resubmission","type":"object","properties":{"success_content":{"type":"string","examples":["Thanks!"]},"message":{"type":"string","examples":["Form successfully submitted"]}},"examples":[{"success_content":"Thanks!","message":"Form successfully submitted"}]},{"description":"","type":"object","properties":{"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","examples":["user:custom_textarea_attribute"]},"type":{"type":"string","examples":["textarea"]},"required":{"type":"boolean","examples":[false]},"label":{"type":"string","examples":["custom textarea attribute"]}}},"examples":[[{"name":"user:custom_textarea_attribute","type":"textarea","required":false,"label":"custom textarea attribute"},{"name":"user:custom_text_attribute","type":"text","required":false,"label":"custom text attribute"},{"name":"user:custom_select_attribute","type":"select","required":false,"label":"custom select attribute","options":{"show_blank":true,"values":[{"value":63,"text":"AAAAAAAA","source_value":"aaaaaaaaaa"},{"value":64,"text":"Rigger","source_value":"user_select_item_1"},{"value":65,"text":"Physical Therapist Assistant","source_value":"user_select_item_2"},{"value":66,"text":"Gas Plant Operator","source_value":"user_select_item_3"},{"value":67,"text":"Forming Machine Operator","source_value":"user_select_item_4"},{"value":68,"text":"Credit Authorizer","source_value":"user_select_item_5"},{"value":69,"text":"Garment","source_value":"user_select_item_6"},{"value":70,"text":"Ship Engineer","source_value":"user_select_item_7"},{"value":71,"text":"Kindergarten Teacher","source_value":"user_select_item_8"},{"value":72,"text":"Photographic Process Worker","source_value":"user_select_item_9"},{"value":73,"text":"Decorator","source_value":"user_select_item_10"}]}},{"name":"user:custom_number_attribute","type":"number","required":false,"label":"custom number attribute","options":{"min":-999999.99,"max":999999.99,"step":"0.01"}},{"name":"user:custom_email_attribute","type":"email","required":false,"label":"custom email attribute"},{"name":"user:custom_boolean_attribute","type":"boolean","required":false,"label":"custom boolean attribute"}]]},"rrns":{"type":"object","properties":{"user_form_submission":{"type":"string","examples":["rrn:local:20101:user_form_submission:2"]},"user":{"type":"string","examples":["rrn:local:20101:user:xxxxxxxxxxxxxxxxxxxxxxxx"]}}},"public":{"type":"integer","examples":[0]},"title":{"type":["string","null"],"examples":[null]},"success_content":{"type":"string","examples":[""]},"close_content":{"type":"string","examples":[""]},"values":{"type":"array","examples":[[]]},"options":{"type":"object","properties":{"resubmit":{"type":"boolean","examples":[true]},"read_only":{"type":"boolean","examples":[false]}}},"submissions":{"type":"array","items":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[2]},"form_id":{"type":"integer","examples":[37]},"user_id":{"type":"integer","examples":[23453473]},"entity":{"type":"string","examples":["user_form_submission"]},"entity_id":{"type":"integer","examples":[2]},"data":{"type":"array","examples":[[]]},"requires_resubmission":{"type":"integer","examples":[0]},"deleted_at":{"type":["string","null"],"examples":[null]},"is_erased":{"type":"integer","examples":[0]},"created_at":{"type":"string","examples":["2026-08-17T04:57:55.000000Z"]},"updated_at":{"type":"string","examples":["2026-08-17T04:57:55.000000Z"]},"custom_address_attribute":{"type":["string","null"],"examples":[null]},"custom_boolean_attribute":{"type":["string","null"],"examples":[null]},"custom_country_attribute":{"type":["string","null"],"examples":[null]},"custom_date_attribute":{"type":["string","null"],"examples":[null]},"custom_datetime_attribute":{"type":["string","null"],"examples":[null]},"custom_document_attribute":{"type":["string","null"],"examples":[null]},"custom_email_attribute":{"type":["string","null"],"examples":[null]},"custom_file_attribute":{"type":["string","null"],"examples":[null]},"custom_html_attribute":{"type":["string","null"],"examples":[null]},"custom_image_attribute":{"type":["string","null"],"examples":[null]},"custom_multiselect_attribute":{"type":["string","null"],"examples":[null]},"custom_number_attribute":{"type":["string","null"],"examples":[null]},"custom_rating_attribute":{"type":["string","null"],"examples":[null]},"custom_select_attribute":{"type":["string","null"],"examples":[null]},"custom_telephone_attribute":{"type":["string","null"],"examples":[null]},"custom_text_attribute":{"type":["string","null"],"examples":[null]},"custom_textarea_attribute":{"type":["string","null"],"examples":[null]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:user_form_submission:2"]}}},"relations":{"type":"object","properties":{}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[false]}}},"attributes":{"type":"object","properties":{}}}},"examples":[[{"object":{"id":2,"form_id":37,"user_id":23453473,"entity":"user_form_submission","entity_id":2,"data":[],"requires_resubmission":0,"deleted_at":null,"is_erased":0,"created_at":"2026-08-17T04:57:55.000000Z","updated_at":"2026-08-17T04:57:55.000000Z","custom_address_attribute":null,"custom_boolean_attribute":null,"custom_country_attribute":null,"custom_date_attribute":null,"custom_datetime_attribute":null,"custom_document_attribute":null,"custom_email_attribute":null,"custom_file_attribute":null,"custom_html_attribute":null,"custom_image_attribute":null,"custom_multiselect_attribute":null,"custom_number_attribute":null,"custom_rating_attribute":null,"custom_select_attribute":null,"custom_telephone_attribute":null,"custom_text_attribute":null,"custom_textarea_attribute":null},"nice":{"rrn":"rrn:local:20101:user_form_submission:2"},"relations":[],"permissions":{"read":true,"update":true,"delete":false},"attributes":[]}]]}},"examples":[{"fields":[{"name":"user:custom_textarea_attribute","type":"textarea","required":false,"label":"custom textarea attribute"},{"name":"user:custom_text_attribute","type":"text","required":false,"label":"custom text attribute"},{"name":"user:custom_select_attribute","type":"select","required":false,"label":"custom select attribute","options":{"show_blank":true,"values":[{"value":63,"text":"AAAAAAAA","source_value":"aaaaaaaaaa"},{"value":64,"text":"Rigger","source_value":"user_select_item_1"},{"value":65,"text":"Physical Therapist Assistant","source_value":"user_select_item_2"},{"value":66,"text":"Gas Plant Operator","source_value":"user_select_item_3"},{"value":67,"text":"Forming Machine Operator","source_value":"user_select_item_4"},{"value":68,"text":"Credit Authorizer","source_value":"user_select_item_5"},{"value":69,"text":"Garment","source_value":"user_select_item_6"},{"value":70,"text":"Ship Engineer","source_value":"user_select_item_7"},{"value":71,"text":"Kindergarten Teacher","source_value":"user_select_item_8"},{"value":72,"text":"Photographic Process Worker","source_value":"user_select_item_9"},{"value":73,"text":"Decorator","source_value":"user_select_item_10"}]}},{"name":"user:custom_number_attribute","type":"number","required":false,"label":"custom number attribute","options":{"min":-999999.99,"max":999999.99,"step":"0.01"}},{"name":"user:custom_email_attribute","type":"email","required":false,"label":"custom email attribute"},{"name":"user:custom_boolean_attribute","type":"boolean","required":false,"label":"custom boolean attribute"}],"rrns":{"user_form_submission":"rrn:local:20101:user_form_submission:2","user":"rrn:local:20101:user:xxxxxxxxxxxxxxxxxxxxxxxx"},"public":0,"title":null,"success_content":"","close_content":"","values":[],"options":{"resubmit":true,"read_only":false},"submissions":[{"object":{"id":2,"form_id":37,"user_id":23453473,"entity":"user_form_submission","entity_id":2,"data":[],"requires_resubmission":0,"deleted_at":null,"is_erased":0,"created_at":"2026-08-17T04:57:55.000000Z","updated_at":"2026-08-17T04:57:55.000000Z","custom_address_attribute":null,"custom_boolean_attribute":null,"custom_country_attribute":null,"custom_date_attribute":null,"custom_datetime_attribute":null,"custom_document_attribute":null,"custom_email_attribute":null,"custom_file_attribute":null,"custom_html_attribute":null,"custom_image_attribute":null,"custom_multiselect_attribute":null,"custom_number_attribute":null,"custom_rating_attribute":null,"custom_select_attribute":null,"custom_telephone_attribute":null,"custom_text_attribute":null,"custom_textarea_attribute":null},"nice":{"rrn":"rrn:local:20101:user_form_submission:2"},"relations":{},"permissions":{"read":true,"update":true,"delete":false},"attributes":{}}]}]}]},"id":"schema_489"},"schema_490":{"kind":"json-schema","data":{"type":"integer","examples":[23453468]},"id":"schema_490"},"schema_491":{"kind":"json-schema","data":{"type":"object","properties":{"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","examples":["user:custom_textarea_attribute"]},"type":{"type":"string","examples":["textarea"]},"required":{"type":"boolean","examples":[false]},"label":{"type":"string","examples":["custom textarea attribute"]}}},"examples":[[{"name":"user:custom_textarea_attribute","type":"textarea","required":false,"label":"custom textarea attribute"},{"name":"user:custom_text_attribute","type":"text","required":false,"label":"custom text attribute"},{"name":"user:custom_select_attribute","type":"select","required":false,"label":"custom select attribute","options":{"show_blank":true,"values":[{"value":63,"text":"AAAAAAAA","source_value":"aaaaaaaaaa"},{"value":64,"text":"Rigger","source_value":"user_select_item_1"},{"value":65,"text":"Physical Therapist Assistant","source_value":"user_select_item_2"},{"value":66,"text":"Gas Plant Operator","source_value":"user_select_item_3"},{"value":67,"text":"Forming Machine Operator","source_value":"user_select_item_4"},{"value":68,"text":"Credit Authorizer","source_value":"user_select_item_5"},{"value":69,"text":"Garment","source_value":"user_select_item_6"},{"value":70,"text":"Ship Engineer","source_value":"user_select_item_7"},{"value":71,"text":"Kindergarten Teacher","source_value":"user_select_item_8"},{"value":72,"text":"Photographic Process Worker","source_value":"user_select_item_9"},{"value":73,"text":"Decorator","source_value":"user_select_item_10"}]}},{"name":"user:custom_number_attribute","type":"number","required":false,"label":"custom number attribute","options":{"min":-999999.99,"max":999999.99,"step":"0.01"}},{"name":"user:custom_email_attribute","type":"email","required":false,"label":"custom email attribute"},{"name":"user:custom_boolean_attribute","type":"boolean","required":false,"label":"custom boolean attribute"}]]},"rrns":{"type":"object","properties":{"user":{"type":"string","examples":["rrn:local:20101:user:xxxxxxxxxxxxxxxxxxxxxxxx"]}}}},"examples":[{"fields":[{"name":"user:custom_textarea_attribute","type":"textarea","required":false,"label":"custom textarea attribute"},{"name":"user:custom_text_attribute","type":"text","required":false,"label":"custom text attribute"},{"name":"user:custom_select_attribute","type":"select","required":false,"label":"custom select attribute","options":{"show_blank":true,"values":[{"value":63,"text":"AAAAAAAA","source_value":"aaaaaaaaaa"},{"value":64,"text":"Rigger","source_value":"user_select_item_1"},{"value":65,"text":"Physical Therapist Assistant","source_value":"user_select_item_2"},{"value":66,"text":"Gas Plant Operator","source_value":"user_select_item_3"},{"value":67,"text":"Forming Machine Operator","source_value":"user_select_item_4"},{"value":68,"text":"Credit Authorizer","source_value":"user_select_item_5"},{"value":69,"text":"Garment","source_value":"user_select_item_6"},{"value":70,"text":"Ship Engineer","source_value":"user_select_item_7"},{"value":71,"text":"Kindergarten Teacher","source_value":"user_select_item_8"},{"value":72,"text":"Photographic Process Worker","source_value":"user_select_item_9"},{"value":73,"text":"Decorator","source_value":"user_select_item_10"}]}},{"name":"user:custom_number_attribute","type":"number","required":false,"label":"custom number attribute","options":{"min":-999999.99,"max":999999.99,"step":"0.01"}},{"name":"user:custom_email_attribute","type":"email","required":false,"label":"custom email attribute"},{"name":"user:custom_boolean_attribute","type":"boolean","required":false,"label":"custom boolean attribute"}],"rrns":{"user":"rrn:local:20101:user:xxxxxxxxxxxxxxxxxxxxxxxx"}}]},"id":"schema_491"},"schema_492":{"kind":"json-schema","data":{"type":"object","properties":{"user:{field}":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A field value, keyed by the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" the render"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"response gives it. The set of fields differs per form."},"children":[]}]}]}],"examples":["Called and left a message"]}}},"id":"schema_492"},"schema_493":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","examples":["Form successfully submitted"]}},"examples":[{"message":"Form successfully submitted"}]},"id":"schema_493"},"schema_494":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","examples":["Admin access required for this form"]}},"examples":[{"message":"Admin access required for this form"}]},"id":"schema_494"},"schema_495":{"kind":"json-schema","data":{"type":"object","properties":{"account_id":{"type":"integer","description":"The account to copy the form into. Defaults to the\n  account the form is already in.","examples":[20101]}}},"id":"schema_495"},"schema_496":{"kind":"json-schema","data":{"oneOf":[{"description":"copied into another account","type":"object","properties":{"message":{"type":"string","examples":["Successfully copied form"]}},"examples":[{"message":"Successfully copied form"}]},{"description":"","type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[37]},"form_type_id":{"type":"integer","examples":[15]},"name":{"type":"string","examples":["Volunteer Application"]},"form_title":{"type":"string","examples":["Volunteer Application"]},"form_category_id":{"type":["string","null"],"examples":[null]},"success_content":{"type":"string","examples":[""]},"close_content":{"type":"string","examples":[""]},"options":{"type":"array","examples":[[]]},"rules":{"type":"array","examples":[[]]},"cost":{"type":"string","examples":["0.00"]},"tax_percentage":{"type":"string","examples":["0.00"]},"close_at":{"type":["string","null"],"examples":[null]},"public":{"type":"integer","examples":[0]},"is_archived":{"type":"integer","examples":[0]},"token":{"type":"string","examples":["xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"]},"deleted_at":{"type":["string","null"],"examples":[null]},"created_at":{"type":"string","examples":["2026-06-09T05:36:25.000000Z"]},"updated_at":{"type":"string","examples":["2026-06-09T05:36:25.000000Z"]},"deleted_by":{"type":["string","null"],"examples":[null]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:form:37"]},"is_open":{"type":"string","examples":["Yes"]},"close_at":{"type":["string","null"],"examples":[null]},"is_foreign_account":{"type":"boolean","examples":[false]}}},"relations":{"type":"object","properties":{"form_type":{"type":"object","properties":{"id":{"type":"integer","examples":[15]},"name":{"type":"string","examples":["User Interaction - New answers for new submissions"]},"code":{"type":"string","examples":["user_submission"]},"main_entity":{"type":"string","examples":["user_form_submission"]},"entities":{"type":"object","properties":{"user_form_submission":{"type":"object","properties":{"create":{"type":"boolean","examples":[true]}}}}},"public_field":{"type":"object","properties":{"form_title":{"type":"object","properties":{"rules":{"type":"string","examples":["required|json"]},"validation":{"type":"string","examples":["required"]}}},"close_content":{"type":"object","properties":{"rules":{"type":"string","examples":["nullable|json"]},"validation":{"type":"string","examples":["string"]}}},"success_content":{"type":"object","properties":{"rules":{"type":"string","examples":["required|json"]},"validation":{"type":"string","examples":["required"]}}}}},"access":{"type":"string","examples":["form"]}}}}},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[false]},"copy":{"type":"boolean","examples":[false]}}}},"examples":[{"object":{"id":37,"form_type_id":15,"name":"Volunteer Application","form_title":"Volunteer Application","form_category_id":null,"success_content":"","close_content":"","options":[],"rules":[],"cost":"0.00","tax_percentage":"0.00","close_at":null,"public":0,"is_archived":0,"token":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","deleted_at":null,"created_at":"2026-06-09T05:36:25.000000Z","updated_at":"2026-06-09T05:36:25.000000Z","deleted_by":null},"nice":{"rrn":"rrn:local:20101:form:37","is_open":"Yes","close_at":null,"is_foreign_account":false},"relations":{"form_type":{"id":15,"name":"User Interaction - New answers for new submissions","code":"user_submission","main_entity":"user_form_submission","entities":{"user_form_submission":{"create":true}},"public_field":{"form_title":{"rules":"required|json","validation":"required"},"close_content":{"rules":"nullable|json","validation":"string"},"success_content":{"rules":"required|json","validation":"required"}},"access":"form"}},"permissions":{"read":true,"update":true,"delete":false,"copy":false}}]}]},"id":"schema_496"},"schema_497":{"kind":"json-schema","data":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The file format. One of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"xlsx"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"csv"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Defaults to"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"xlsx"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":["csv"]},"id":"schema_497"},"schema_498":{"kind":"json-schema","data":{"type":"object","properties":{"queue":{"type":"string","examples":["yRw7YnOU4MqaSwsVVJlNV4PI"]}},"examples":[{"queue":"yRw7YnOU4MqaSwsVVJlNV4PI"}]},"id":"schema_498"},"schema_499":{"kind":"json-schema","data":{"type":"array","items":{"type":"object","properties":{"current_page":{"type":"integer","examples":[1]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[1]},"form_id":{"type":"integer","examples":[36]},"data":{"type":"object","properties":{"user:custom_text_attribute":{"type":"string","examples":["Example answer"]},"user:custom_email_attribute":{"type":"string","examples":["respondent@example.com"]},"user:custom_number_attribute":{"type":"integer","examples":[42]},"user:custom_eav_multiselect_1":{"type":["string","null"],"examples":[null]},"user:custom_textarea_attribute":{"type":"string","examples":["A longer example answer."]},"user:custom_multiselect_attribute":{"type":["string","null"],"examples":[null]}}},"created_at":{"type":"string","examples":["2026-08-17T04:57:54.000000Z"]},"updated_at":{"type":"string","examples":["2026-08-17T04:57:54.000000Z"]}}},"nice":{"type":"array","examples":[[]]},"relations":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[false]},"delete":{"type":"boolean","examples":[false]}}}}},"examples":[[{"object":{"id":1,"form_id":36,"data":{"user:custom_text_attribute":"Example answer","user:custom_email_attribute":"respondent@example.com","user:custom_number_attribute":42,"user:custom_eav_multiselect_1":null,"user:custom_textarea_attribute":"A longer example answer.","user:custom_multiselect_attribute":null},"created_at":"2026-08-17T04:57:54.000000Z","updated_at":"2026-08-17T04:57:54.000000Z"},"nice":[],"relations":[],"permissions":{"read":true,"update":false,"delete":false}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}]]},"first_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/form/{form}/submission?per_page=5&_locale=en-US&page=1"]},"from":{"type":"integer","examples":[1]},"next_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/form/{form}/submission?per_page=5&_locale=en-US&page=2"]},"path":{"type":"string","examples":["https://example.rosterfy.com/api/v2/form/{form}/submission"]},"per_page":{"type":"integer","examples":[5]},"prev_page_url":{"type":["string","null"],"examples":[null]},"to":{"type":"integer","examples":[5]}}},"examples":[[{"current_page":1,"data":[{"object":{"id":1,"form_id":36,"data":{"user:custom_text_attribute":"Example answer","user:custom_email_attribute":"respondent@example.com","user:custom_number_attribute":42,"user:custom_eav_multiselect_1":null,"user:custom_textarea_attribute":"A longer example answer.","user:custom_multiselect_attribute":null},"created_at":"2026-08-17T04:57:54.000000Z","updated_at":"2026-08-17T04:57:54.000000Z"},"nice":[],"relations":[],"permissions":{"read":true,"update":false,"delete":false}},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}],"first_page_url":"https://example.rosterfy.com/api/v2/form/{form}/submission?per_page=5&_locale=en-US&page=1","from":1,"next_page_url":"https://example.rosterfy.com/api/v2/form/{form}/submission?per_page=5&_locale=en-US&page=2","path":"https://example.rosterfy.com/api/v2/form/{form}/submission","per_page":5,"prev_page_url":null,"to":5}]]},"id":"schema_499"},"schema_500":{"kind":"json-schema","data":{"type":"array","description":"A list of extras to include in the response. These are objects or arrays that are not part of\nthe model's primary attributes, such as stats and counts.\nFor fast responses, avoid requesting them if you don't need them. ","items":{"type":"string","enum":["entity"]},"examples":[["entity"]]},"id":"schema_500"},"schema_501":{"kind":"json-schema","data":{"type":"array","items":{"type":"object","properties":{"current_page":{"type":"integer","examples":[1]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"object","properties":{"id":{"type":"integer","examples":[2]},"form_id":{"type":"integer","examples":[37]},"user_id":{"type":"integer","examples":[23453473]},"entity":{"type":"string","examples":["user_form_submission"]},"entity_id":{"type":"integer","examples":[2]},"data":{"type":"array","examples":[[]]},"requires_resubmission":{"type":"integer","examples":[0]},"deleted_at":{"type":["string","null"],"examples":[null]},"is_erased":{"type":"integer","examples":[0]},"created_at":{"type":"string","examples":["2026-08-17T04:57:55.000000Z"]},"updated_at":{"type":"string","examples":["2026-08-17T04:57:55.000000Z"]}}},"nice":{"type":"object","properties":{"rrn":{"type":"string","examples":["rrn:local:20101:user_form_submission:2"]}}},"relations":{"type":"array","examples":[[]]},"permissions":{"type":"object","properties":{"read":{"type":"boolean","examples":[true]},"update":{"type":"boolean","examples":[true]},"delete":{"type":"boolean","examples":[false]}}},"attributes":{"type":"array","examples":[[]]}}},"examples":[[{"object":{"id":2,"form_id":37,"user_id":23453473,"entity":"user_form_submission","entity_id":2,"data":[],"requires_resubmission":0,"deleted_at":null,"is_erased":0,"created_at":"2026-08-17T04:57:55.000000Z","updated_at":"2026-08-17T04:57:55.000000Z"},"nice":{"rrn":"rrn:local:20101:user_form_submission:2"},"relations":[],"permissions":{"read":true,"update":true,"delete":false},"attributes":[]},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}]]},"first_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/user/{user}/form/user-submission?per_page=5&_locale=en-US&page=1"]},"from":{"type":"integer","examples":[1]},"next_page_url":{"type":"string","examples":["https://example.rosterfy.com/api/v2/user/{user}/form/user-submission?per_page=5&_locale=en-US&page=2"]},"path":{"type":"string","examples":["https://example.rosterfy.com/api/v2/user/{user}/form/user-submission"]},"per_page":{"type":"integer","examples":[5]},"prev_page_url":{"type":["string","null"],"examples":[null]},"to":{"type":"integer","examples":[5]}}},"examples":[[{"current_page":1,"data":[{"object":{"id":2,"form_id":37,"user_id":23453473,"entity":"user_form_submission","entity_id":2,"data":[],"requires_resubmission":0,"deleted_at":null,"is_erased":0,"created_at":"2026-08-17T04:57:55.000000Z","updated_at":"2026-08-17T04:57:55.000000Z"},"nice":{"rrn":"rrn:local:20101:user_form_submission:2"},"relations":[],"permissions":{"read":true,"update":true,"delete":false},"attributes":[]},{"object":{"id":2}},{"object":{"id":3}},{"object":{"id":4}},{"object":{"id":5}}],"first_page_url":"https://example.rosterfy.com/api/v2/user/{user}/form/user-submission?per_page=5&_locale=en-US&page=1","from":1,"next_page_url":"https://example.rosterfy.com/api/v2/user/{user}/form/user-submission?per_page=5&_locale=en-US&page=2","path":"https://example.rosterfy.com/api/v2/user/{user}/form/user-submission","per_page":5,"prev_page_url":null,"to":5}]]},"id":"schema_501"},"schema_502":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"string","description":"The submitted answers, as a JSON string. Replaces the stored\n  answers outright on every selected submission rather than merging into them.","examples":["{\"user:custom_text_attribute\":\"Example answer\"}"]},"requires_resubmission":{"type":["boolean","null"],"description":"Whether the selected submissions should be\n  marked as needing to be filled in again.","examples":[true]},"filter":{"type":"array","description":"Which of the person's submissions to change. Same shape\n  as the listing's filter. Omit it and every submission they have is changed.","items":{"type":"object"},"examples":[[[]]]}}},"id":"schema_502"},"schema_503":{"kind":"json-schema","data":{"type":"string","examples":["Mass operation succeeded"]},"id":"schema_503"}},"exampleStore":{"paths/~1api~1v2~1oauth~1token/post/requestBody/content/application~1json/examples/password":{"value":{"grant_type":"password","client_id":1234,"client_secret":"{YOUR_CLIENT_SECRET}","username":"integration@example.com","password":"{YOUR_PASSWORD}","scope":"*"},"key":"password","summary":"Initial exchange","id":"paths/~1api~1v2~1oauth~1token/post/requestBody/content/application~1json/examples/password"},"paths/~1api~1v2~1oauth~1token/post/requestBody/content/application~1json/examples/refresh":{"value":{"grant_type":"refresh_token","client_id":1234,"client_secret":"{YOUR_CLIENT_SECRET}","refresh_token":"{YOUR_REFRESH_TOKEN}","scope":"*"},"key":"refresh","summary":"Renewing a token","id":"paths/~1api~1v2~1oauth~1token/post/requestBody/content/application~1json/examples/refresh"},"paths/~1api~1v2~1oauth~1token/post/responses/200/content/application~1json/examples/issued":{"value":{"token_type":"Bearer","expires_in":2592000,"access_token":"{ACCESS_TOKEN}","refresh_token":"{REFRESH_TOKEN}"},"key":"issued","summary":"Token issued","id":"paths/~1api~1v2~1oauth~1token/post/responses/200/content/application~1json/examples/issued"},"paths/~1api~1v2~1oauth~1token/post/responses/400/content/application~1json/examples/unsupported_grant_type":{"value":{"error":"unsupported_grant_type","error_description":"The authorization grant type is not supported by the authorization server.","hint":"Check that all required parameters have been provided","message":"The authorization grant type is not supported by the authorization server."},"key":"unsupported_grant_type","summary":"Unknown grant type","id":"paths/~1api~1v2~1oauth~1token/post/responses/400/content/application~1json/examples/unsupported_grant_type"},"paths/~1api~1v2~1oauth~1token/post/responses/401/content/application~1json/examples/invalid_credentials":{"value":{"message":"Invalid credentials"},"key":"invalid_credentials","summary":"Credentials rejected","id":"paths/~1api~1v2~1oauth~1token/post/responses/401/content/application~1json/examples/invalid_credentials"}},"securitySchemeStore":{"default":{"id":"default","type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for retrieving a Bearer token."},"children":[]}]}]}]}},"servers":[{"url":"/_mock/api-docs/openapi","isMockServer":true,"description":"Mock server"},{"url":"https://{account}.{domain}","description":"Your Rosterfy account","variables":{"account":{"default":"example","description":"Your account's subdomain - the first part of the address you sign in to Rosterfy on."},"domain":{"default":"rosterfy.com","description":"The rest of that address. rosterfy.com unless your account is on a regional deployment, in which case use the domain you sign in on."}}}]},"options":{"hideSidebar":true,"mockServer":{"url":"/_mock/api-docs/openapi","position":"first","description":"Mock server"},"disableRouter":true,"downloadUrls":[{"url":"/_bundle/api-docs/openapi.json?download"},{"url":"/_bundle/api-docs/openapi.yaml?download"}],"excludeFromSearch":false,"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"Rosterfy API Documentation","description":"A guide to using the Rosterfy REST API."}},"baseSlug":"/api-docs/openapi","routesMapping":{}}