{
"code": 500,
"errors": [],
"message": "Internal Server Error"
}
Employees
Shape Employees
Get a list of employees shaped according to the provided shape body.
Supports cursor-based pagination, filtering, and ordering.
Full shape language reference (concepts, every directive, examples for
@property, $id, $inserted_at, $updated_at, $all, the $field
spec ($at / $type / $coerce / $on_error), $relation blocks,
@custom_properties.<key> references, and the $historical block with
$valid_from_field / $valid_to_field):
/platform/other/data-shape.
The at query parameter sets a request-level “as of” date for flat
field resolution; a root $at in the shape body overrides it, and a
per-field $at overrides both. Failed $type coercions are reported in
the response warnings array (the request still returns 200).
Returns 400 for any shape parsing problem, 403 when the role lacks
access to the employee resource or when the shape references a field
outside the role’s authorized field set.
Note: This operation is experimental and may change in the future.
Bracket syntax, two keys per filtered field: filters[<field>][op]=<op>&filters[<field>][value]=<value>, e.g. filters[updated_at][op]=gt&filters[updated_at][value]=2026-01-01T00:00:00Z. Combine fields by adding more keys; every filter must match.
With op=in, separate the values with commas: filters[id][op]=in&filters[id][value]=<uuid>,<uuid>. filters[id][value][]=<uuid>&filters[id][value][]=<uuid> is accepted too.
Id of an organization-wide condition (see GET /v1/org/conditions) whose domain is
employee. Only records the condition passes are returned; filters still apply
first. Record properties are encrypted at rest, so the condition runs in the
application after the page is read and decrypted: a page may be shorter than first,
even empty, while has_next_page is still true. Keep paging until has_next_page
is false. pagination[last] /
pagination[before] are not supported together with a condition. An unknown id or a
condition of another domain is a 400. No permission on conditions is needed to filter
by one; list on this resource is enough.
Body
application/json
ShapeRequest
Inline shape describing how employee data should be projected. Full reference: /platform/other/data-shape.
Type-validation warnings produced while shaping (failed $type coercions). Each entry carries employee_id, path, property, expected_type, value, and action.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Twine Integrations","colors":{"primary":"#7600ff","light":"#ad66ff","dark":"#7600ff"},"logo":{"light":"https://mintcdn.com/entwineab/W0WCY-b2dvTokvLn/logo/light.svg?fit=max\u0026auto=format\u0026n=W0WCY-b2dvTokvLn\u0026q=85\u0026s=7e70d0ec35e8816f98a512eafa2ad35b","dark":"https://mintcdn.com/entwineab/W0WCY-b2dvTokvLn/logo/dark.svg?fit=max\u0026auto=format\u0026n=W0WCY-b2dvTokvLn\u0026q=85\u0026s=bcf15f923005d67de257a74c061db962"},"favicon":"https://mintcdn.com/entwineab/OPi-j2jbIEGoK6fy/favicon.svg?fit=max\u0026auto=format\u0026n=OPi-j2jbIEGoK6fy\u0026q=85\u0026s=190facce372d84ae3de157af3da0688e","navbar":{"links":[{"href":"mailto:[email protected]","label":"Support"},{"href":"https://app-stage.twine.se","label":"Stage"}],"primary":{"type":"button","label":"App","href":"https://app.twine.se"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"twine.se","icon":"globe","href":"https://www.twine.se"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"entwineab","hasAudioNarration":false,"actualSubdomain":"entwineab","customDomains":["docs.twine.se"],"gitSource":{"type":"github","owner":"twine-se","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6acf668b4788a74327b72032","collectionId":"027bd1b7-2940-449a-bfcf-f8ccfca1f9a2","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6acf668b4788a74327b72032"},"entitlements":{},"buildId":"6acf668b4788a74327b72032","clientVersion":"0.0.3966","searchFilterCounts":[{"language":"default","tag":"API Reference","count":149},{"language":"default","tag":"Data Engine","count":86},{"language":"default","tag":"Integrations","count":72},{"language":"default","tag":"Flow Engine","count":41},{"language":"default","tag":"Platform","count":33},{"language":"default","tag":"Assigns","count":28},{"language":"default","tag":"Flow Control","count":19},{"language":"default","tag":"Transformation","count":19},{"language":"default","tag":"Changelog","count":18},{"language":"default","tag":"HRIS","count":14}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/employees/shape-employees","slug":"/api-reference/employees/shape-employees","pageMetadata":{"title":"Shape Employees","description":"Get a list of employees shaped according to the provided shape body.\nSupports cursor-based pagination, filtering, and ordering.\n\nFull shape language reference (concepts, every directive, examples for\n`@property`, `$id`, `$inserted_at`, `$updated_at`, `$all`, the `$field`\nspec (`$at` / `$type` / `$coerce` / `$on_error`), `$relation` blocks,\n`@custom_properties.\u003ckey>` references, and the `$historical` block with\n`$valid_from_field` / `$valid_to_field`):\n[/platform/other/data-shape](/platform/other/data-shape).\n\nThe `at` query parameter sets a request-level \"as of\" date for flat\nfield resolution; a root `$at` in the shape body overrides it, and a\nper-field `$at` overrides both. Failed `$type` coercions are reported in\nthe response `warnings` array (the request still returns `200`).\n\nReturns `400` for any shape parsing problem, `403` when the role lacks\naccess to the employee resource or when the shape references a field\noutside the role's authorized field set.\n\n*Note*: This operation is experimental and may change in the future.\n","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /v1/org/employees/shape","href":"/api-reference/employees/shape-employees","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n code: \"code\",\n em: \"em\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Get a list of employees shaped according to the provided shape body.\\nSupports cursor-based pagination, filtering, and ordering.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Full shape language reference (concepts, every directive, examples for\\n\", _jsx(_components.code, {\n children: \"@property\"\n }), \", \", _jsx(_components.code, {\n children: \"$id\"\n }), \", \", _jsx(_components.code, {\n children: \"$inserted_at\"\n }), \", \", _jsx(_components.code, {\n children: \"$updated_at\"\n }), \", \", _jsx(_components.code, {\n children: \"$all\"\n }), \", the \", _jsx(_components.code, {\n children: \"$field\"\n }), \"\\nspec (\", _jsx(_components.code, {\n children: \"$at\"\n }), \" / \", _jsx(_components.code, {\n children: \"$type\"\n }), \" / \", _jsx(_components.code, {\n children: \"$coerce\"\n }), \" / \", _jsx(_components.code, {\n children: \"$on_error\"\n }), \"), \", _jsx(_components.code, {\n children: \"$relation\"\n }), \" blocks,\\n\", _jsx(_components.code, {\n children: \"@custom_properties.\u003ckey>\"\n }), \" references, and the \", _jsx(_components.code, {\n children: \"$historical\"\n }), \" block with\\n\", _jsx(_components.code, {\n children: \"$valid_from_field\"\n }), \" / \", _jsx(_components.code, {\n children: \"$valid_to_field\"\n }), \"):\\n\", _jsx(_components.a, {\n href: \"/platform/other/data-shape\",\n children: \"/platform/other/data-shape\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"The \", _jsx(_components.code, {\n children: \"at\"\n }), \" query parameter sets a request-level “as of” date for flat\\nfield resolution; a root \", _jsx(_components.code, {\n children: \"$at\"\n }), \" in the shape body overrides it, and a\\nper-field \", _jsx(_components.code, {\n children: \"$at\"\n }), \" overrides both. Failed \", _jsx(_components.code, {\n children: \"$type\"\n }), \" coercions are reported in\\nthe response \", _jsx(_components.code, {\n children: \"warnings\"\n }), \" array (the request still returns \", _jsx(_components.code, {\n children: \"200\"\n }), \").\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Returns \", _jsx(_components.code, {\n children: \"400\"\n }), \" for any shape parsing problem, \", _jsx(_components.code, {\n children: \"403\"\n }), \" when the role lacks\\naccess to the employee resource or when the shape references a field\\noutside the role’s authorized field set.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.em, {\n children: \"Note\"\n }), \": This operation is experimental and may change in the future.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Shape Employees","description":"Get a list of employees shaped according to the provided shape body.\nSupports cursor-based pagination, filtering, and ordering.\n\nFull shape language reference (concepts, every directive, examples for\n`@property`, `$id`, `$inserted_at`, `$updated_at`, `$all`, the `$field`\nspec (`$at` / `$type` / `$coerce` / `$on_error`), `$relation` blocks,\n`@custom_properties.\u003ckey>` references, and the `$historical` block with\n`$valid_from_field` / `$valid_to_field`):\n[/platform/other/data-shape](/platform/other/data-shape).\n\nThe `at` query parameter sets a request-level \"as of\" date for flat\nfield resolution; a root `$at` in the shape body overrides it, and a\nper-field `$at` overrides both. Failed `$type` coercions are reported in\nthe response `warnings` array (the request still returns `200`).\n\nReturns `400` for any shape parsing problem, `403` when the role lacks\naccess to the employee resource or when the shape references a field\noutside the role's authorized field set.\n\n*Note*: This operation is experimental and may change in the future.\n","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /v1/org/employees/shape","href":"/api-reference/employees/shape-employees","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"callbacks":{},"description":"Get a list of employees shaped according to the provided shape body.\nSupports cursor-based pagination, filtering, and ordering.\n\nFull shape language reference (concepts, every directive, examples for\n`@property`, `$id`, `$inserted_at`, `$updated_at`, `$all`, the `$field`\nspec (`$at` / `$type` / `$coerce` / `$on_error`), `$relation` blocks,\n`@custom_properties.\u003ckey>` references, and the `$historical` block with\n`$valid_from_field` / `$valid_to_field`):\n[/platform/other/data-shape](/platform/other/data-shape).\n\nThe `at` query parameter sets a request-level \"as of\" date for flat\nfield resolution; a root `$at` in the shape body overrides it, and a\nper-field `$at` overrides both. Failed `$type` coercions are reported in\nthe response `warnings` array (the request still returns `200`).\n\nReturns `400` for any shape parsing problem, `403` when the role lacks\naccess to the employee resource or when the shape references a field\noutside the role's authorized field set.\n\n*Note*: This operation is experimental and may change in the future.\n","operationId":"shapeEmployees","parameters":["19391a52-36dc-4400-a5e7-0aa9c16af23d","e73643bd-f3aa-469c-a24a-316e3149c889","57806ea9-86c6-4c5b-850a-91f1d8829531","889ddced-f123-411f-bde4-8c964929d2b9","7ca915eb-dac2-409d-b8bc-05ce56c2c571"],"requestBody":"2de35bb6-6884-4abe-9209-3551568747aa","responses":{"200":"d5d5fcd2-d341-4538-9752-c1d14763caa2","400":"5e8735bc-81f5-41ba-96a9-c14f9edeaf0b","403":"845381f2-0110-47ad-8b1c-344d5158a8b9","500":"d65932db-93a0-4745-bb7a-c07586adad1a"},"summary":"Shape Employees","tags":["Employees"],"method":"post","type":"path","servers":["9052e5c0-34df-47d4-8603-693bab08bcc0","c9338b87-25eb-4aa8-b3fe-b99dae164f43"],"security":["48248fe8-3acb-4be1-b40f-8384723ebc05"],"path":"/v1/org/employees/shape","baseUrlOptions":["https://api.twine.se","https://api-stage.twine.se"],"title":"Shape Employees","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"19391a52-36dc-4400-a5e7-0aa9c16af23d":{"description":"Request-level 'as of' date (ISO 8601) for flat field resolution.","in":"query","name":"at","required":false,"schema":{"format":"date","type":"string","isRequired":false,"description":"Request-level 'as of' date (ISO 8601) for flat field resolution.","uniqueKey":"","typeLabel":"string\u003cdate>"}},"e73643bd-f3aa-469c-a24a-316e3149c889":{"description":"Bracket syntax, one key per field: `pagination[first]=50`, then `pagination[first]=50\u0026pagination[after]=\u003cend_cursor>` for the next page.\n","explode":true,"in":"query","name":"pagination","required":false,"schema":{"description":"Bracket syntax, one key per field: `pagination[first]=50`, then `pagination[first]=50\u0026pagination[after]=\u003cend_cursor>` for the next page.\n\nCursor pagination","properties":{"after":{"oneOf":[{"description":"Cursor to start after. Is returned in the response. Must be specified together with `first`. Leave undefined to start at the beginning","type":"string","uniqueKey":"after.oneOf.0","typeLabel":"string"},{"description":"Cursor to start after. Is returned in the response. Must be specified together with `first`. Leave undefined to start at the beginning","type":"null","uniqueKey":"after.oneOf.1","typeLabel":"null"}],"uniqueKey":"after","typeLabel":"string | null"},"before":{"oneOf":[{"description":"Cursor to start before. Is returned in the response. Must be specified together with `last`. Leave undefined to start at the end","type":"string","uniqueKey":"before.oneOf.0","typeLabel":"string"},{"description":"Cursor to start before. Is returned in the response. Must be specified together with `last`. Leave undefined to start at the end","type":"null","uniqueKey":"before.oneOf.1","typeLabel":"null"}],"uniqueKey":"before","typeLabel":"string | null"},"first":{"oneOf":[{"description":"Number of subsequent items to return. Must be specified together with `after`. Will be capped at 100, unless otherwise specified","type":"integer","uniqueKey":"first.oneOf.0","typeLabel":"integer"},{"description":"Number of subsequent items to return. Must be specified together with `after`. Will be capped at 100, unless otherwise specified","type":"null","uniqueKey":"first.oneOf.1","typeLabel":"null"}],"uniqueKey":"first","typeLabel":"integer | null"},"last":{"oneOf":[{"description":"Number of previous items to return. Must be specified together with `before`. Will be capped at 100, unless otherwise specified","type":"integer","uniqueKey":"last.oneOf.0","typeLabel":"integer"},{"description":"Number of previous items to return. Must be specified together with `before`. Will be capped at 100, unless otherwise specified","type":"null","uniqueKey":"last.oneOf.1","typeLabel":"null"}],"uniqueKey":"last","typeLabel":"integer | null"}},"title":"CursorPagination","type":"object","isRequired":false,"uniqueKey":"","typeLabel":"CursorPagination · object"},"style":"deepObject"},"57806ea9-86c6-4c5b-850a-91f1d8829531":{"description":"Filter parameters for Employee\n\nBracket syntax, two keys per filtered field: `filters[\u003cfield>][op]=\u003cop>\u0026filters[\u003cfield>][value]=\u003cvalue>`, e.g. `filters[updated_at][op]=gt\u0026filters[updated_at][value]=2026-01-01T00:00:00Z`. Combine fields by adding more keys; every filter must match.\n\nWith `op=in`, separate the values with commas: `filters[id][op]=in\u0026filters[id][value]=\u003cuuid>,\u003cuuid>`. `filters[id][value][]=\u003cuuid>\u0026filters[id][value][]=\u003cuuid>` is accepted too.\n","explode":true,"in":"query","name":"filters","required":false,"schema":{"description":"Filter parameters for Employee\n\nBracket syntax, two keys per filtered field: `filters[\u003cfield>][op]=\u003cop>\u0026filters[\u003cfield>][value]=\u003cvalue>`, e.g. `filters[updated_at][op]=gt\u0026filters[updated_at][value]=2026-01-01T00:00:00Z`. Combine fields by adding more keys; every filter must match.\n\nWith `op=in`, separate the values with commas: `filters[id][op]=in\u0026filters[id][value]=\u003cuuid>,\u003cuuid>`. `filters[id][value][]=\u003cuuid>\u0026filters[id][value][]=\u003cuuid>` is accepted too.\n\nParameters for Employee filtering","properties":{"active_status":{"description":"Active status for the Employee. Will be expanded in the future","properties":{"op":{"enum":["eq"],"type":"string","isRequired":true,"uniqueKey":"active_status.op","typeLabel":"enum\u003cstring>"},"value":{"enum":["active","inactive"],"type":"string","isRequired":true,"uniqueKey":"active_status.value","typeLabel":"enum\u003cstring>"}},"required":["value","op"],"type":"object","uniqueKey":"active_status","typeLabel":"object"},"id":{"description":"Employee UUID. With `in`, separate the values with commas.","properties":{"op":{"enum":["eq","in"],"type":"string","isRequired":true,"uniqueKey":"id.op","typeLabel":"enum\u003cstring>"},"value":{"type":"string","isRequired":true,"uniqueKey":"id.value","typeLabel":"string"}},"required":["value","op"],"type":"object","uniqueKey":"id","typeLabel":"object"},"inserted_at":{"description":"Inserted at timestamp","properties":{"op":{"enum":["eq","gt","lt","gte","lte"],"type":"string","isRequired":true,"uniqueKey":"inserted_at.op","typeLabel":"enum\u003cstring>"},"value":{"format":"date-time","type":"string","isRequired":true,"uniqueKey":"inserted_at.value","typeLabel":"string\u003cdate-time>"}},"required":["value","op"],"type":"object","uniqueKey":"inserted_at","typeLabel":"object"},"is_currently_manager":{"description":"Filter by whether the employee is currently a manager","properties":{"op":{"enum":["eq"],"type":"string","isRequired":true,"uniqueKey":"is_currently_manager.op","typeLabel":"enum\u003cstring>"},"value":{"type":"boolean","isRequired":true,"uniqueKey":"is_currently_manager.value","typeLabel":"boolean"}},"required":["value","op"],"type":"object","uniqueKey":"is_currently_manager","typeLabel":"object"},"updated_at":{"description":"Updated at timestamp","properties":{"op":{"enum":["eq","gt","lt","gte","lte"],"type":"string","isRequired":true,"uniqueKey":"updated_at.op","typeLabel":"enum\u003cstring>"},"value":{"format":"date-time","type":"string","isRequired":true,"uniqueKey":"updated_at.value","typeLabel":"string\u003cdate-time>"}},"required":["value","op"],"type":"object","uniqueKey":"updated_at","typeLabel":"object"}},"title":"EmployeeFilter","type":"object","isRequired":false,"uniqueKey":"","typeLabel":"EmployeeFilter · object"},"style":"deepObject"},"889ddced-f123-411f-bde4-8c964929d2b9":{"description":"Bracket syntax: `order[field]=\u003cfield>\u0026order[direction]=desc`.","explode":true,"in":"query","name":"order","required":false,"schema":{"description":"Bracket syntax: `order[field]=\u003cfield>\u0026order[direction]=desc`.\nParameters for Employee ordering","properties":{"direction":{"enum":["asc","desc"],"type":"string","isRequired":true,"uniqueKey":"direction","typeLabel":"enum\u003cstring>"},"field":{"enum":["id","inserted_at","updated_at","active_status"],"type":"string","isRequired":true,"uniqueKey":"field","typeLabel":"enum\u003cstring>"}},"required":["field","direction"],"title":"EmployeeOrder","type":"object","isRequired":false,"uniqueKey":"","typeLabel":"EmployeeOrder · object"},"style":"deepObject"},"7ca915eb-dac2-409d-b8bc-05ce56c2c571":{"description":"Id of an organization-wide condition (see `GET /v1/org/conditions`) whose domain is\n`employee`. Only records the condition passes are returned; `filters` still apply\nfirst. Record properties are encrypted at rest, so the condition runs in the\napplication after the page is read and decrypted: a page may be shorter than `first`,\neven empty, while `has_next_page` is still `true`. Keep paging until `has_next_page`\nis `false`. `pagination[last]` /\n`pagination[before]` are not supported together with a condition. An unknown id or a\ncondition of another domain is a `400`. No permission on conditions is needed to filter\nby one; `list` on this resource is enough.\n","in":"query","name":"condition_id","required":false,"schema":{"format":"uuid","type":"string","isRequired":false,"description":"Id of an organization-wide condition (see `GET /v1/org/conditions`) whose domain is\n`employee`. Only records the condition passes are returned; `filters` still apply\nfirst. Record properties are encrypted at rest, so the condition runs in the\napplication after the page is read and decrypted: a page may be shorter than `first`,\neven empty, while `has_next_page` is still `true`. Keep paging until `has_next_page`\nis `false`. `pagination[last]` /\n`pagination[before]` are not supported together with a condition. An unknown id or a\ncondition of another domain is a `400`. No permission on conditions is needed to filter\nby one; `list` on this resource is enough.\n","uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"requestBody":{"content":{"application/json":{"schema":{"description":"Inline shape describing how employee data should be projected. Full reference: /platform/other/data-shape.","properties":{"shape":{"description":"Shape body. See /platform/other/data-shape for the full language reference.","type":"object","isRequired":true,"uniqueKey":"shape","typeLabel":"object"}},"required":["shape"],"title":"ShapeRequest","type":"object","uniqueKey":"","typeLabel":"ShapeRequest · object"},"examples":{"Example":{"title":"Example","value":{"shape":{}}}},"exampleType":"generated"}},"description":"ShapeRequest","required":false,"exampleType":"generated"},"responses":{"d5d5fcd2-d341-4538-9752-c1d14763caa2":{"content":{"application/json":{"schema":{"description":"A paginated list of shaped employees","properties":{"data":{"items":{"type":"object","uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"data","typeLabel":"object[]"},"pagination":{"description":"Cursor pagination result","properties":{"end_cursor":{"oneOf":[{"description":"Cursor to start after to retrieve the next page","type":"string","uniqueKey":"pagination.end_cursor.oneOf.0","typeLabel":"string"},{"description":"Cursor to start after to retrieve the next page","type":"null","uniqueKey":"pagination.end_cursor.oneOf.1","typeLabel":"null"}],"uniqueKey":"pagination.end_cursor","typeLabel":"string | null"},"has_next_page":{"description":"If true, there are additional items available after the current page","type":"boolean","uniqueKey":"pagination.has_next_page","typeLabel":"boolean"},"has_previous_page":{"description":"If true, there are additional items available before the current page","type":"boolean","uniqueKey":"pagination.has_previous_page","typeLabel":"boolean"},"start_cursor":{"oneOf":[{"description":"Cursor to start before to retrieve the previous page","type":"string","uniqueKey":"pagination.start_cursor.oneOf.0","typeLabel":"string"},{"description":"Cursor to start before to retrieve the previous page","type":"null","uniqueKey":"pagination.start_cursor.oneOf.1","typeLabel":"null"}],"uniqueKey":"pagination.start_cursor","typeLabel":"string | null"}},"title":"CursorPaginationResult","type":"object","isRequired":true,"uniqueKey":"pagination","typeLabel":"CursorPaginationResult · object"},"warnings":{"description":"Type-validation warnings produced while shaping (failed `$type` coercions). Each entry carries `employee_id`, `path`, `property`, `expected_type`, `value`, and `action`.","items":{"type":"object","uniqueKey":"warnings.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"warnings","typeLabel":"object[]"}},"required":["data","pagination"],"title":"ShapedEmployeeListResponse","type":"object","uniqueKey":"","typeLabel":"ShapedEmployeeListResponse · object"},"examples":{"Example":{"title":"Example","value":{"data":[{}],"pagination":{"end_cursor":"\u003cstring>","has_next_page":true,"has_previous_page":true,"start_cursor":"\u003cstring>"},"warnings":[{}]}}},"exampleType":"generated"}},"description":"Employee list Response","exampleType":"generated"},"5e8735bc-81f5-41ba-96a9-c14f9edeaf0b":{"content":{"application/json":{"schema":{"description":"Bad request error","properties":{"code":{"example":400,"type":"integer","isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"errors":{"default":[],"items":{"description":"Singular error","properties":{"domain":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].domain","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"reason":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].reason","typeLabel":"string"}},"required":["domain","reason","message"],"title":"InnerError","type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"InnerError · object"},"type":"array","isRequired":true,"uniqueKey":"errors","typeLabel":"InnerError · object[]"},"message":{"example":"Bad Request","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["code","message","errors"],"title":"BadRequestError","type":"object","uniqueKey":"","typeLabel":"BadRequestError · object"},"examples":{"Example":{"title":"Example","value":{"code":400,"errors":[],"message":"Bad Request"}}},"exampleType":"generated"}},"description":"Bad Request Response","exampleType":"generated"},"845381f2-0110-47ad-8b1c-344d5158a8b9":{"content":{"application/json":{"schema":{"description":"Forbidden error","properties":{"code":{"example":403,"type":"integer","isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"errors":{"default":[],"items":{"description":"Singular error","properties":{"domain":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].domain","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"reason":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].reason","typeLabel":"string"}},"required":["domain","reason","message"],"title":"InnerError","type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"InnerError · object"},"type":"array","isRequired":true,"uniqueKey":"errors","typeLabel":"InnerError · object[]"},"message":{"example":"Forbidden","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["code","message","errors"],"title":"ForbiddenError","type":"object","uniqueKey":"","typeLabel":"ForbiddenError · object"},"examples":{"Example":{"title":"Example","value":{"code":403,"errors":[],"message":"Forbidden"}}},"exampleType":"generated"}},"description":"Forbidden Response","exampleType":"generated"},"d65932db-93a0-4745-bb7a-c07586adad1a":{"content":{"application/json":{"schema":{"description":"Internal server error","properties":{"code":{"example":500,"type":"integer","isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"errors":{"default":[],"items":{"description":"Singular error","properties":{"domain":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].domain","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"reason":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].reason","typeLabel":"string"}},"required":["domain","reason","message"],"title":"InnerError","type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"InnerError · object"},"type":"array","isRequired":true,"uniqueKey":"errors","typeLabel":"InnerError · object[]"},"message":{"example":"Internal Server Error","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["code","message","errors"],"title":"InternalServerError","type":"object","uniqueKey":"","typeLabel":"InternalServerError · object"},"examples":{"Example":{"title":"Example","value":{"code":500,"errors":[],"message":"Internal Server Error"}}},"exampleType":"generated"}},"description":"Internal Error Response","exampleType":"generated"}},"security":{"48248fe8-3acb-4be1-b40f-8384723ebc05":{"BearerAuth":{"bearerFormat":"JWT","description":"Bearer token for authentication","scheme":"bearer","type":"http","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"9052e5c0-34df-47d4-8603-693bab08bcc0":{"description":"Twine Public Production API","url":"https://api.twine.se","variables":{}},"c9338b87-25eb-4aa8-b3fe-b99dae164f43":{"description":"Twine Public Staging API","url":"https://api-stage.twine.se","variables":{}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"bearerFormat":"JWT","description":"Bearer token for authentication","scheme":"bearer","type":"http","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer token for authentication","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"https://api.twine.se/spec/openapi.json"},"subdomain":"entwineab","siteName":"Twine Integrations","title":"Shape Employees - Twine Integrations","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-14T11:25:10.136Z","originalFileLocation":"api-reference/employees/shape-employees.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Get a list of employees shaped according to the provided shape body. Supports cursor-based pagination, filtering, and ordering. Full shape language reference (concepts, every directive, examples for @property, $id, $inserted_at, $updated_at, $all, the $field spec ($at / $type / $coerce / $on_error), $relation blocks, @custom_properties. references, and the $historical block with $valid_from_field / $valid_to_field): /platform/other/data-shape. The at query parameter sets a request-level \u0026quot;as of\u0026quot; date for flat field resolution; a root $at in the shape body overrides it, and a per-field $at overrides both. Failed $type coercions are reported in the response warnings array (the request still returns 200). Returns 400 for any shape parsing problem, 403 when the role lacks access to the employee resource or when the shape references a field outside the role\u0026#x27;s authorized field set. Note: This operation is experimental and may change in the future.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Twine Integrations\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/entwineab/8LV-a3cLiAT4An4I/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/entwineab/8LV-a3cLiAT4An4I/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/entwineab/8LV-a3cLiAT4An4I/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/entwineab/8LV-a3cLiAT4An4I/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/entwineab/8LV-a3cLiAT4An4I/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/entwineab/8LV-a3cLiAT4An4I/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/entwineab/8LV-a3cLiAT4An4I/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/entwineab/8LV-a3cLiAT4An4I/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/entwineab/8LV-a3cLiAT4An4I/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Shape Employees - Twine Integrations\">\u003cmeta data-mint-head property=\"og:description\" content=\"Get a list of employees shaped according to the provided shape body. Supports cursor-based pagination, filtering, and ordering. Full shape language reference (concepts, every directive, examples for @property, $id, $inserted_at, $updated_at, $all, the $field spec ($at / $type / $coerce / $on_error), $relation blocks, @custom_properties. references, and the $historical block with $valid_from_field / $valid_to_field): /platform/other/data-shape. The at query parameter sets a request-level \u0026quot;as of\u0026quot; date for flat field resolution; a root $at in the shape body overrides it, and a per-field $at overrides both. Failed $type coercions are reported in the response warnings array (the request still returns 200). Returns 400 for any shape parsing problem, 403 when the role lacks access to the employee resource or when the shape references a field outside the role\u0026#x27;s authorized field set. Note: This operation is experimental and may change in the future.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Twine Integrations\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.twine.se/api-reference/employees/shape-employees\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://entwineab.mintlify.app/_mintlify/api/og/v2?division=Employees\u0026amp;title=Shape+Employees\u0026amp;description=Get+a+list+of+employees+shaped+according+to+the+provided+shape+body.%0ASupports+cursor-based+pagination%2C+filtering%2C+and+ordering.%0A%0AFull+shape+language+reference+%28\u0026amp;theme=30a0ce2375f0bc6afd332c94\u0026amp;signature=b96a1cc336bfa104b6ea73ee7e6929a6d3471a013bd3099ff8b1d2f0d8268363\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Shape Employees - Twine Integrations\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Get a list of employees shaped according to the provided shape body. Supports cursor-based pagination, filtering, and ordering. Full shape language reference (concepts, every directive, examples for @property, $id, $inserted_at, $updated_at, $all, the $field spec ($at / $type / $coerce / $on_error), $relation blocks, @custom_properties. references, and the $historical block with $valid_from_field / $valid_to_field): /platform/other/data-shape. The at query parameter sets a request-level \u0026quot;as of\u0026quot; date for flat field resolution; a root $at in the shape body overrides it, and a per-field $at overrides both. Failed $type coercions are reported in the response warnings array (the request still returns 200). Returns 400 for any shape parsing problem, 403 when the role lacks access to the employee resource or when the shape references a field outside the role\u0026#x27;s authorized field set. Note: This operation is experimental and may change in the future.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://entwineab.mintlify.app/_mintlify/api/og/v2?division=Employees\u0026amp;title=Shape+Employees\u0026amp;description=Get+a+list+of+employees+shaped+according+to+the+provided+shape+body.%0ASupports+cursor-based+pagination%2C+filtering%2C+and+ordering.%0A%0AFull+shape+language+reference+%28\u0026amp;theme=30a0ce2375f0bc6afd332c94\u0026amp;signature=b96a1cc336bfa104b6ea73ee7e6929a6d3471a013bd3099ff8b1d2f0d8268363\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/entwineab/8LV-a3cLiAT4An4I/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Twine Integrations\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7600ff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.twine.se/api-reference/employees/shape-employees\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/employees/shape-employees.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.twine.se/#organization\",\"name\":\"Twine Integrations\",\"url\":\"https://docs.twine.se\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/entwineab/W0WCY-b2dvTokvLn/logo/light.svg?fit=max\u0026auto=format\u0026n=W0WCY-b2dvTokvLn\u0026q=85\u0026s=7e70d0ec35e8816f98a512eafa2ad35b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.twine.se#website\",\"name\":\"Twine Integrations\",\"url\":\"https://docs.twine.se\",\"publisher\":{\"@id\":\"https://docs.twine.se/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.twine.se/api-reference/employees/shape-employees#webpage\",\"url\":\"https://docs.twine.se/api-reference/employees/shape-employees\",\"name\":\"Shape Employees\",\"description\":\"Get a list of employees shaped according to the provided shape body. Supports cursor-based pagination, filtering, and ordering. Full shape language reference (concepts, every directive, examples for @property, $id, $inserted_at, $updated_at, $all, the $field spec ($at / $type / $coerce / $on_error), $relation blocks, @custom_properties. references, and the $historical block with $valid_from_field / $valid_to_field): /platform/other/data-shape. The at query parameter sets a request-level \\\"as of\\\" date for flat field resolution; a root $at in the shape body overrides it, and a per-field $at overrides both. Failed $type coercions are reported in the response warnings array (the request still returns 200). Returns 400 for any shape parsing problem, 403 when the role lacks access to the employee resource or when the shape references a field outside the role's authorized field set. Note: This operation is experimental and may change in the future.\",\"dateModified\":\"2026-10-14T11:25:10.136Z\",\"isPartOf\":{\"@id\":\"https://docs.twine.se#website\"},\"breadcrumb\":{\"@id\":\"https://docs.twine.se/api-reference/employees/shape-employees#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.twine.se/api-reference/employees/shape-employees#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.twine.se/api-reference/users/get-users\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Employees\",\"item\":\"https://docs.twine.se/api-reference/employees/get-employees\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Shape Employees\",\"item\":\"https://docs.twine.se/api-reference/employees/shape-employees\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.twine.se/api-reference/employees/shape-employees#apireference\",\"headline\":\"Shape Employees\",\"name\":\"Shape Employees\",\"description\":\"Get a list of employees shaped according to the provided shape body. Supports cursor-based pagination, filtering, and ordering. Full shape language reference (concepts, every directive, examples for @property, $id, $inserted_at, $updated_at, $all, the $field spec ($at / $type / $coerce / $on_error), $relation blocks, @custom_properties. references, and the $historical block with $valid_from_field / $valid_to_field): /platform/other/data-shape. The at query parameter sets a request-level \\\"as of\\\" date for flat field resolution; a root $at in the shape body overrides it, and a per-field $at overrides both. Failed $type coercions are reported in the response warnings array (the request still returns 200). Returns 400 for any shape parsing problem, 403 when the role lacks access to the employee resource or when the shape references a field outside the role's authorized field set. Note: This operation is experimental and may change in the future.\",\"url\":\"https://docs.twine.se/api-reference/employees/shape-employees\",\"mainEntityOfPage\":{\"@id\":\"https://docs.twine.se/api-reference/employees/shape-employees#webpage\"},\"dateModified\":\"2026-10-14T11:25:10.136Z\",\"publisher\":{\"@id\":\"https://docs.twine.se/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.twine.se#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Twine Integrations\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Twine Integrations","nav":{"global":{"anchors":[{"anchor":"twine.se","icon":"globe","href":"https://www.twine.se"}]},"tabs":[{"tab":"Overview","pages":[{"title":"Overview","href":"/overview"}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations"}]},{"tab":"Platform","pages":[{"title":"Platform","href":"/platform"}]},{"tab":"Backoffice","pages":[{"title":"Backoffice","href":"/backoffice"}]},{"tab":"Flow Engine","pages":[{"title":"Flow Engine","href":"/flow-engine"}]},{"tab":"Data Engine","pages":[{"title":"Data Engine","href":"/data-engine"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]},{"tab":"API Reference","groups":[{"group":"API Documentation","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Provisioning","href":"/api-reference/provisioning"},{"title":"Filtering and ordering","href":"/api-reference/filtering-and-ordering"},{"title":"Pushing data","href":"/api-reference/pushing-data"}]},{"group":"API Reference","pages":[{"group":"Users","pages":[{"title":"Get Users","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/users","href":"/api-reference/users/get-users"}]},{"group":"Competences","pages":[{"title":"Get Competence","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/competences/{competence_id}","href":"/api-reference/competences/get-competence"},{"title":"Replace Competence","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json put /v1/org/competences/{competence_id}","href":"/api-reference/competences/replace-competence"},{"title":"Delete Competence","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json delete /v1/org/competences/{competence_id}","href":"/api-reference/competences/delete-competence"},{"title":"Update Competence","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json patch /v1/org/competences/{competence_id}","href":"/api-reference/competences/update-competence"},{"title":"Get Competences","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/competences","href":"/api-reference/competences/get-competences"},{"title":"Create Competence","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /v1/org/competences","href":"/api-reference/competences/create-competence"}]},{"group":"Organizations","pages":[{"title":"Get organizations","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org","href":"/api-reference/organizations/get-organizations"},{"title":"Create organization","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /v1/org","href":"/api-reference/organizations/create-organization"},{"title":"Get organization","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/{org_id}","href":"/api-reference/organizations/get-organization"}]},{"group":"DomainMappings","pages":[{"title":"Delete Domain Mapping Sync Trigger","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json delete /v1/org/domain-mappings/{domain_mapping_id}/sync-triggers/{sync_trigger_id}","href":"/api-reference/domainmappings/delete-domain-mapping-sync-trigger"},{"title":"Fire Domain Mapping Sync Trigger","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /v1/org/domain-mappings/{domain_mapping_id}/sync-triggers/{sync_trigger_id}/fire","href":"/api-reference/domainmappings/fire-domain-mapping-sync-trigger"},{"title":"Get Domain Mapping","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/domain-mappings/{domain_mapping_id}","href":"/api-reference/domainmappings/get-domain-mapping"},{"title":"Update Domain Mapping","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json put /v1/org/domain-mappings/{domain_mapping_id}","href":"/api-reference/domainmappings/update-domain-mapping"},{"title":"Delete Domain Mapping","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json delete /v1/org/domain-mappings/{domain_mapping_id}","href":"/api-reference/domainmappings/delete-domain-mapping"},{"title":"Get Domain Mappings","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/domain-mappings","href":"/api-reference/domainmappings/get-domain-mappings"},{"title":"Create Domain Mapping","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /v1/org/domain-mappings","href":"/api-reference/domainmappings/create-domain-mapping"}]},{"group":"SystemIntegrations","pages":[{"title":"Get System Integration","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/system-integrations/{id}","href":"/api-reference/systemintegrations/get-system-integration"},{"title":"Update System Integration","deprecated":true,"version":null,"openapi":"https://api.twine.se/spec/openapi.json put /v1/org/system-integrations/{id}","href":"/api-reference/systemintegrations/update-system-integration"},{"title":"Partially Update System Integration","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json patch /v1/org/system-integrations/{id}","href":"/api-reference/systemintegrations/partially-update-system-integration"},{"title":"Create Credentials Link","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /v1/org/system-integrations/{id}/credentials-link","href":"/api-reference/systemintegrations/create-credentials-link"},{"title":"Get System Integration Fields","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/system-integrations/{id}/fields/{domain}","href":"/api-reference/systemintegrations/get-system-integration-fields"},{"title":"Get System Integrations","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/system-integrations","href":"/api-reference/systemintegrations/get-system-integrations"},{"title":"Create System Integration","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /v1/org/system-integrations","href":"/api-reference/systemintegrations/create-system-integration"}]},{"group":"File Transfers","pages":[{"title":"Get File Transfers","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/file-transfers","href":"/api-reference/file-transfers/get-file-transfers"},{"title":"Upload File","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /v1/org/file-transfers","href":"/api-reference/file-transfers/upload-file"},{"title":"Get File Transfer","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/file-transfers/{file_transfer_id}","href":"/api-reference/file-transfers/get-file-transfer"}]},{"group":"System Time Types","pages":[{"title":"Get System Time Type","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/time-reports/system-time-types/{system_integration_id}/{system_time_type_id}","href":"/api-reference/system-time-types/get-system-time-type"},{"title":"Update System Time Type","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json put /v1/org/time-reports/system-time-types/{system_integration_id}/{system_time_type_id}","href":"/api-reference/system-time-types/update-system-time-type"},{"title":"Delete System Time Type","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json delete /v1/org/time-reports/system-time-types/{system_integration_id}/{system_time_type_id}","href":"/api-reference/system-time-types/delete-system-time-type"},{"title":"Get System Time Types","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/time-reports/system-time-types/{system_integration_id}","href":"/api-reference/system-time-types/get-system-time-types"},{"title":"Create System Time Type","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /v1/org/time-reports/system-time-types/{system_integration_id}","href":"/api-reference/system-time-types/create-system-time-type"}]},{"group":"EmployeeMappings","pages":[{"title":"Get Employee Mappings","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/employees/mappings","href":"/api-reference/employeemappings/get-employee-mappings"},{"title":"Create Employee Mapping","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /v1/org/employees/mappings","href":"/api-reference/employeemappings/create-employee-mapping"},{"title":"Update Employee Mapping","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json put /v1/org/employees/mappings/{employee_mapping_id}","href":"/api-reference/employeemappings/update-employee-mapping"},{"title":"Delete Employee Mapping","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json delete /v1/org/employees/mappings/{employee_mapping_id}","href":"/api-reference/employeemappings/delete-employee-mapping"}]},{"group":"Time Reports","pages":[{"title":"Get Time Reports","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/time-reports","href":"/api-reference/time-reports/get-time-reports"},{"title":"Create Time Report","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /v1/org/time-reports","href":"/api-reference/time-reports/create-time-report"},{"title":"Get Time Report","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/time-reports/{time_report_id}","href":"/api-reference/time-reports/get-time-report"},{"title":"Update Time Report","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json put /v1/org/time-reports/{time_report_id}","href":"/api-reference/time-reports/update-time-report"},{"title":"Delete Time Report","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json delete /v1/org/time-reports/{time_report_id}","href":"/api-reference/time-reports/delete-time-report"}]},{"group":"Provisioning","pages":[{"title":"Refresh token","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /provisioning/refresh-token/refresh","href":"/api-reference/provisioning/refresh-token"},{"title":"Begin refresh token process","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /provisioning/refresh-token/begin","href":"/api-reference/provisioning/begin-refresh-token-process"}]},{"group":"Systems","pages":[{"title":"Get System Fields","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/systems/{system_id}/fields/{domain}","href":"/api-reference/systems/get-system-fields"},{"title":"Get Systems","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/systems","href":"/api-reference/systems/get-systems"}]},{"group":"Organizational Units","pages":[{"title":"Get Organizational Units","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v2/org/organizational-units","href":"/api-reference/organizational-units/get-organizational-units"},{"title":"Get Organizational Unit","deprecated":true,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/organizational-units/{id}","href":"/api-reference/organizational-units/get-organizational-unit"},{"title":"Get Organizational Units","deprecated":true,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/organizational-units","href":"/api-reference/organizational-units/get-organizational-units-1"},{"title":"Get Organizational Unit","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v2/org/organizational-units/{id}","href":"/api-reference/organizational-units/get-organizational-unit-1"}]},{"group":"Jobs","pages":[{"title":"Get Job by ID","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/jobs/{job_id}","href":"/api-reference/jobs/get-job-by-id"},{"title":"Get Jobs","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/jobs","href":"/api-reference/jobs/get-jobs"}]},{"group":"DataEngine","pages":[{"title":"Get DataEngine Node Docs","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/data-engine/docs","href":"/api-reference/dataengine/get-dataengine-node-docs"}]},{"group":"Conditions","pages":[{"title":"Get Condition by ID","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/conditions/{condition_id}","href":"/api-reference/conditions/get-condition-by-id"},{"title":"Get Conditions","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/conditions","href":"/api-reference/conditions/get-conditions"}]},{"group":"Employees","pages":[{"title":"Get Employees","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/employees","href":"/api-reference/employees/get-employees"},{"title":"Create Employee","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /v1/org/employees","href":"/api-reference/employees/create-employee"},{"title":"Get Employee","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/employees/{employee_id}","href":"/api-reference/employees/get-employee"},{"title":"Put Employee","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json put /v1/org/employees/{employee_id}","href":"/api-reference/employees/put-employee"},{"title":"Patch Employee","description":"Partially update an existing employee in the organization. The request body should contain the fields to be updated. Null values will be ignored.\nOnly supports dated properties model.\n","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json patch /v1/org/employees/{employee_id}","href":"/api-reference/employees/patch-employee"},{"title":"Shape Employees","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /v1/org/employees/shape","href":"/api-reference/employees/shape-employees"}]},{"group":"Employee Competences","pages":[{"title":"Get Employee Competence","description":null,"deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/employee-competences/{employee_competence_id}","href":"/api-reference/employee-competences/get-employee-competence"},{"title":"Replace Employee Competence","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json put /v1/org/employee-competences/{employee_competence_id}","href":"/api-reference/employee-competences/replace-employee-competence"},{"title":"Delete Employee Competence","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json delete /v1/org/employee-competences/{employee_competence_id}","href":"/api-reference/employee-competences/delete-employee-competence"},{"title":"Update Employee Competence","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json patch /v1/org/employee-competences/{employee_competence_id}","href":"/api-reference/employee-competences/update-employee-competence"},{"title":"Get Employee Competences","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/employee-competences","href":"/api-reference/employee-competences/get-employee-competences"},{"title":"Create Employee Competence","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /v1/org/employee-competences","href":"/api-reference/employee-competences/create-employee-competence"}]},{"group":"Salary Transactions","pages":[{"title":"Get Salary Transactions","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/salary-transactions","href":"/api-reference/salary-transactions/get-salary-transactions"},{"title":"Create Salary Transaction","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /v1/org/salary-transactions","href":"/api-reference/salary-transactions/create-salary-transaction"},{"title":"Get Salary Transaction","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/salary-transactions/{salary_transaction_id}","href":"/api-reference/salary-transactions/get-salary-transaction"},{"title":"Replace Salary Transaction","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json put /v1/org/salary-transactions/{salary_transaction_id}","href":"/api-reference/salary-transactions/replace-salary-transaction"},{"title":"Delete Salary Transaction","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json delete /v1/org/salary-transactions/{salary_transaction_id}","href":"/api-reference/salary-transactions/delete-salary-transaction"},{"title":"Update Salary Transaction","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json patch /v1/org/salary-transactions/{salary_transaction_id}","href":"/api-reference/salary-transactions/update-salary-transaction"}]}]}]}]},"title":"Shape Employees - Twine Integrations","buildId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","deploymentId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DKJwRUt2.js","utils-CWD_VS3u.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-oFjciODD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C76WsxC3.js","snippetPresets-DvPMxpX_.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CuNQfndH.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BVFpVUoF.js","shallow-t59Jg5Kr.js","getApiPlaygroundDisplay-C_JZ4amX.js","CodeSnippet-CLRDnx_h.js","CodeSnippets-C2myU4kc.js","Page-7TwLLapg.js","getPastedJson-B-JaVXw7.js","icon-BA-iDhH3.js","MethodPill-D4qZABFp.js","DuplicateIcon-THIDKO1O.js","createIcon-CYYJwgFd.js","DynamicMarkdown-UGQuxDKp.js","SectionHeading-jYELb23h.js","axios-vUo_bRtp.js","Markdown-DKsLa3wy.js","clsx-CefdjKz2.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BaREnp3o.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-sgx_0XzF.js"]}