{ "opencollection": "1.0.0", "info": { "name": "Yokoy Card account Policy API", "version": "1.41.0" }, "items": [ { "info": { "name": "Policy", "type": "folder" }, "items": [ { "info": { "name": "List all policies for a legal entity", "type": "http" }, "http": { "method": "GET", "url": "https://api.yokoy.ai/v1/organizations/{organizationId}/legal-entities/:legalEntityId/policies", "headers": [ { "name": "X-Yk-Auth-Method", "value": "yokoy" }, { "name": "X-Yk-Correlation-Id", "value": "4ea8985e-80a2-40a0-8a40-401a1a1374b3" } ], "params": [ { "name": "legalEntityId", "value": "aB9jQoE3HE", "type": "path", "description": "Yokoy unique ID of the legal entity (company)." }, { "name": "filter", "value": "created ge 2024-03-02T09:00.000Z and customInformation.customField eq foo", "type": "query", "description": "Filter string used to restrict the data returned. You can use [SCIM specification](https://tools.ietf.org/html/rfc7644#section-3.4.2.2) filters." } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://accounts[.test].yokoy.ai/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Returns all employee policies for the legal entity specified by its Yokoy unique ID in the path." }, { "info": { "name": "Create a policy", "type": "http" }, "http": { "method": "POST", "url": "https://api.yokoy.ai/v1/organizations/{organizationId}/legal-entities/:legalEntityId/policies", "headers": [ { "name": "X-Yk-Auth-Method", "value": "yokoy" }, { "name": "X-Yk-Correlation-Id", "value": "4ea8985e-80a2-40a0-8a40-401a1a1374b3" } ], "params": [ { "name": "legalEntityId", "value": "aB9jQoE3HE", "type": "path", "description": "Yokoy unique ID of the legal entity (company)." } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://accounts[.test].yokoy.ai/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Creates a new employee policy and returns the created entity." }, { "info": { "name": "Get a policy by ID", "type": "http" }, "http": { "method": "GET", "url": "https://api.yokoy.ai/v1/organizations/{organizationId}/legal-entities/:legalEntityId/policies/:policyId", "headers": [ { "name": "X-Yk-Auth-Method", "value": "yokoy" }, { "name": "X-Yk-Correlation-Id", "value": "4ea8985e-80a2-40a0-8a40-401a1a1374b3" } ], "params": [ { "name": "legalEntityId", "value": "aB9jQoE3HE", "type": "path", "description": "Yokoy unique ID of the legal entity (company)." }, { "name": "policyId", "value": "06x2u4nagAMEq3gGoMch", "type": "path", "description": "Yokoy unique ID of the employee policy." } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://accounts[.test].yokoy.ai/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves an employee policy specified by its Yokoy unique ID." }, { "info": { "name": "Update a policy", "type": "http" }, "http": { "method": "PUT", "url": "https://api.yokoy.ai/v1/organizations/{organizationId}/legal-entities/:legalEntityId/policies/:policyId", "headers": [ { "name": "X-Yk-Auth-Method", "value": "yokoy" }, { "name": "X-Yk-Correlation-Id", "value": "4ea8985e-80a2-40a0-8a40-401a1a1374b3" } ], "params": [ { "name": "legalEntityId", "value": "aB9jQoE3HE", "type": "path", "description": "Yokoy unique ID of the legal entity (company)." }, { "name": "policyId", "value": "06x2u4nagAMEq3gGoMch", "type": "path", "description": "Yokoy unique ID of the employee policy." } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://accounts[.test].yokoy.ai/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Updates an employee policy identified by its Yokoy unique ID, replacing all attributes. The legal entity and policy are specified by their unique IDs in the path. Any policy attributes that are not specified in the request body are updated with null or \"\". The whole entity is returned." }, { "info": { "name": "Modify a policy", "type": "http" }, "http": { "method": "PATCH", "url": "https://api.yokoy.ai/v1/organizations/{organizationId}/legal-entities/:legalEntityId/policies/:policyId", "headers": [ { "name": "X-Yk-Auth-Method", "value": "yokoy" }, { "name": "X-Yk-Correlation-Id", "value": "4ea8985e-80a2-40a0-8a40-401a1a1374b3" } ], "params": [ { "name": "legalEntityId", "value": "aB9jQoE3HE", "type": "path", "description": "Yokoy unique ID of the legal entity (company)." }, { "name": "policyId", "value": "06x2u4nagAMEq3gGoMch", "type": "path", "description": "Yokoy unique ID of the employee policy." } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://accounts[.test].yokoy.ai/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Updates an employee policy by replacing some attributes. The legal entity and policy are specified by their unique IDs in the path. `name` and `id` must be passed in the request body. The whole entity is returned." } ] } ], "bundled": true }