{"openapi":"3.0.0","paths":{"/health":{"get":{"operationId":"ApiController_health","summary":"Health check endpoint.","description":"Checks service health and Gyre connectivity. Health status values can be: \"healthy\", \"unhealthy\", or \"unknown\". Returns a status-only summary; internal callers presenting the `X-Internal-Token` header receive extended diagnostics (timestamps, host, full Gyre internals).","parameters":[],"responses":{"200":{"description":"Service is healthy and operational.","content":{"application/ld+json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["healthy"],"example":"healthy"},"gyre":{"type":"object","properties":{"status":{"type":"string","enum":["healthy","unhealthy","unknown"],"example":"healthy"},"error":{"type":"string","nullable":true,"example":null}}},"mongodb":{"type":"object","properties":{"status":{"type":"string","enum":["healthy","unhealthy","unknown"],"example":"healthy"},"error":{"type":"string","nullable":true,"example":null}}}},"example":{"status":"healthy","gyre":{"status":"healthy","error":null},"mongodb":{"status":"healthy","error":null}}}}}},"500":{"description":"Service health check failed due to internal server error or critical system failure.","content":{"application/ld+json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["healthy"],"example":"healthy"},"gyre":{"type":"object","properties":{"status":{"type":"string","enum":["healthy","unhealthy","unknown"],"example":"unhealthy"},"error":{"type":"string","nullable":true,"example":"Connection timeout"}}},"mongodb":{"type":"object","properties":{"status":{"type":"string","enum":["healthy","unhealthy","unknown"],"example":"unhealthy"},"error":{"type":"string","nullable":true,"example":"MongoDB connection not ready"}}}},"example":{"status":"healthy","gyre":{"status":"unhealthy","error":"Connection timeout"},"mongodb":{"status":"unhealthy","error":"MongoDB connection not ready"}}}}}}},"tags":["Api"]}},"/v1/users/{userId}/apiKeys":{"get":{"operationId":"AuthenticationController_getApiKeysByUserId","summary":"Retrieves the collection of Api Keys resources.","tags":["Authentication"],"parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"name","required":false,"in":"query","schema":{"type":"string"}},{"name":"active","required":false,"in":"query","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Api Key collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/ApiKeyEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"security":[{"bearer":[]}]},"post":{"operationId":"AuthenticationController_postApiKey","summary":"Creates an Api Key.","tags":["Authentication"],"parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostApiKeyDto"}}}},"responses":{"201":{"description":"Api Key resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/ApiKeyEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"security":[{"bearer":[]}]}},"/v1/users/{userId}/apiKeys/{apiKeyId}":{"get":{"operationId":"AuthenticationController_getApiKeyByUserId","summary":"Retrieves an Api Key resource.","tags":["Authentication"],"parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"apiKeyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Api Key resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/ApiKeyEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"security":[{"bearer":[]}]}},"/v1/apiKeys/reset-credits":{"post":{"operationId":"AuthenticationController_resetApiKeyCredits","summary":"Resets credits on every key whose billing period has elapsed.","tags":["Authentication"],"description":"Admin/ops route (master key). Idempotent — only keys with an elapsed period are reset, so it is safe to run on any cadence. Intended trigger: a monthly external scheduler (e.g. Scaleway cron). Pass dry_run=true to preview without mutating.","parameters":[{"name":"dry_run","required":false,"in":"query","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Reset summary"},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"security":[{"api_key":[]}]}},"/v1/users/{userId}/apiKeys/{apiKeyId}/disable":{"patch":{"operationId":"AuthenticationController_disableApiKey","summary":"Disables an Api Key.","tags":["Authentication"],"parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"apiKeyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Api Key resource updated"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"security":[{"bearer":[]}]}},"/v1/organisations/{organisationId}/careers":{"get":{"operationId":"CareerController_getManyByOrganisation","summary":"Retrieves the collection of Career resources.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"name","required":false,"in":"query","schema":{"type":"string"}},{"name":"sector_uuid","required":false,"in":"query","schema":{"type":"string"}},{"name":"job_uuid","required":false,"in":"query","schema":{"type":"string"}},{"name":"orderBy[name]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}}],"responses":{"200":{"description":"Career collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/CareerEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Career"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"CareerController_post","summary":"Creates a Career resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostCareerDto"}}}},"responses":{"201":{"description":"Career resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/CareerEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Career"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/careers":{"get":{"operationId":"CareerController_getManyByOrganisationByUser","summary":"Retrieves the collection of Career resources.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"name","required":false,"in":"query","schema":{"type":"string"}},{"name":"sector_uuid","required":false,"in":"query","schema":{"type":"string"}},{"name":"job_uuid","required":false,"in":"query","schema":{"type":"string"}},{"name":"orderBy[name]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}}],"responses":{"200":{"description":"Career identifier","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/CareerEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Career"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/careers/{careerId}":{"get":{"operationId":"CareerController_getByOrganisation","summary":"Retrieves a Career resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"careerId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Career identifier","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/CareerEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Career"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"CareerController_put","summary":"Replaces a Career resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"careerId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutCareerDto"}}}},"responses":{"200":{"description":"Career resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/CareerEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Career"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"CareerController_delete","summary":"Removes a Career resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"careerId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"Career resource deleted"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Career"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/careers/{careerId}/careerUsers":{"get":{"operationId":"CareerUserController_getManyByOrganisationByCareer","summary":"Retrieves the collection of CareerUser resources.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"careerId","required":true,"in":"path","schema":{"type":"string"}},{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"user_id","required":false,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"CareerUser collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/CareerUserEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["CareerUser"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"CareerUserController_post","summary":"Creates a CareerUser resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"careerId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostCareerUserDto"}}}},"responses":{"201":{"description":"CareerUser resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/CareerUserEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["CareerUser"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/careerUsers":{"get":{"operationId":"CareerUserController_getManyByOrganisationByUser","summary":"Retrieves the collection of CareerUser resources of a user","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"user_id","required":false,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"CareerUser collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/CareerUserEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["CareerUser"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/careers/{careerId}/careerUsers/{careerUserId}":{"get":{"operationId":"CareerUserController_getByOrganisationByCareer","summary":"Retrieves a CareerUser resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"careerId","required":true,"in":"path","schema":{"type":"string"}},{"name":"careerUserId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"CareerUser identifier","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/CareerUserEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["CareerUser"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"CareerUserController_put","summary":"Replaces a CareerUser resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"careerId","required":true,"in":"path","schema":{"type":"string"}},{"name":"careerUserId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutCareerUserDto"}}}},"responses":{"200":{"description":"CareerUser resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/CareerUserEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["CareerUser"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"CareerUserController_delete","summary":"Removes a CareerUser resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"careerId","required":true,"in":"path","schema":{"type":"string"}},{"name":"careerUserId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"CareerUser resource deleted"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["CareerUser"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/certificates":{"get":{"operationId":"UserCertificateController_getManyByUser","summary":"Retrieves the collection of UserCertificate resources.","parameters":[{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"name","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"issuer","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"orderBy[name]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"orderBy[issuer]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserCertificate collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/UserCertificateEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Certificates"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"UserCertificateController_post","summary":"Creates a UserCertificate resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostUserCertificateDto"}}}},"responses":{"201":{"description":"UserCertificate resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserCertificateEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Certificates"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/certificates/{certificateId}":{"get":{"operationId":"UserCertificateController_getByUser","summary":"Retrieves a UserCertificate resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"certificateId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserCertificate resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserCertificateEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Certificates"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"UserCertificateController_put","summary":"Replaces a UserCertificate resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"certificateId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutUserCertificateDto"}}}},"responses":{"200":{"description":"UserCertificate resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserCertificateEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Certificates"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"UserCertificateController_delete","summary":"Removes a UserCertificate resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"certificateId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"UserCertificate resource deleted"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Certificates"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/certificates":{"get":{"operationId":"UserCertificateController_getManyFromOrganisation","summary":"Retrieves the collection of UserCertificate resources.","parameters":[{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"name","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"issuer","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"orderBy[name]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"orderBy[issuer]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserCertificate collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/UserCertificateEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Certificates"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"UserCertificateController_postFromOrganisation","summary":"Creates a UserCertificate resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostUserCertificateDto"}}}},"responses":{"201":{"description":"UserCertificate resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserCertificateEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Certificates"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/certificates/{certificateId}":{"get":{"operationId":"UserCertificateController_getFromOrganisation","summary":"Retrieves a UserCertificate resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"certificateId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserCertificate resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserCertificateEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Certificates"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"UserCertificateController_putFromOrganisation","summary":"Replaces a UserCertificate resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"certificateId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutUserCertificateDto"}}}},"responses":{"200":{"description":"UserCertificate resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserCertificateEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Certificates"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"UserCertificateController_deleteFromOrganisation","summary":"Removes a UserCertificate resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"certificateId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"UserCertificate resource deleted"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Certificates"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/courses":{"get":{"operationId":"CourseController_getManyByOrganisation","summary":"Retrieves the collection of Course resources.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"name","required":false,"in":"query","schema":{"type":"string"}},{"name":"orderBy[name]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}}],"responses":{"200":{"description":"Course collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/CourseEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Course"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"CourseController_post","summary":"Creates a Course resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostCourseDto"}}}},"responses":{"201":{"description":"Course resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/CourseEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Course"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/courses/{courseId}":{"get":{"operationId":"CourseController_getByOrganisation","summary":"Retrieves a Course resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"courseId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Course resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/CourseEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Course"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"CourseController_put","summary":"Replaces a Course resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"courseId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutCourseDto"}}}},"responses":{"200":{"description":"Course resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/CourseEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Course"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"CourseController_delete","summary":"Removes a Course resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"courseId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"Course resource deleted"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Course"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/rawDocuments/treat":{"post":{"operationId":"DocumentController_postOrganisationRawDocumentAndTreat","summary":"Creates a Raw Document resource, treat it and creates a Treated Document resource.","description":"With a CV in pdf given and a userId given (which must be part of your organisation), a [jsonResume schema](https://jsonresume.org/schema) will be extracted and saved into a TreatedDocument resource","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"description":"Fichiers à uploader","content":{"multipart/form-data":{"schema":{"type":"object","properties":{"files":{"type":"array","items":{"type":"string","format":"binary"}}}}}}},"responses":{"201":{"description":"Treated Document resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/TreatedDocumentEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Document"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/rawDocuments/enrich":{"post":{"operationId":"DocumentController_postOrganisationUserRawDocumentAndTreatAndEnrich","summary":"Creates a Raw Document resource for a given user, treat it, creates a Treated Document resource, then enrich it and creates an Enriched Document Resource.","description":"\n        With a CV in pdf given and a userId given (which must be part of your organisation), a [jsonResume schema](https://jsonresume.org/schema) will be extracted and saved into a TreatedDocument resource.\n        Then, a Skillberg enrichment will be proceeded and will assign skills to the resume based on the extracted jsonResume schema.\n        This will then be saved into an EnrichedDocument resource","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"description":"Fichiers à uploader","content":{"multipart/form-data":{"schema":{"type":"object","properties":{"files":{"type":"array","items":{"type":"string","format":"binary"}}}}}}},"responses":{"201":{"description":"Treated Document resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/TreatedDocumentEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Document"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/treatedDocuments/{treatedDocumentId}/correctedTreatedDocuments":{"post":{"operationId":"DocumentController_postOrganisationUserCorrectedTreatedDocument","summary":"Creates a Corrected Treated Document resource.","description":"With a previously given Treated Document resource, creates a Corrected Treated Document resource for a given user. \n      Be careful, after posting this Corrected Treated Document you won't be able to edit it anymore","parameters":[{"name":"treatedDocumentId","required":true,"in":"path","schema":{"type":"string"}},{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostCorrectedTreatedDocumentDto"}}}},"responses":{"201":{"description":"Corrected Treated Document resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/CorrectedTreatedDocumentEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Document"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/correctedTreatedDocuments/{correctedTreatedDocumentId}":{"put":{"operationId":"DocumentController_putOrganisationUserCorrectedTreatedDocument","summary":"Replaces a Corrected Treated Document resource.","description":"With a Corrected Treated Document id, replace the data linked to the id. Be careful, one the operation is done the data won't be available for reading/updating anymore","parameters":[{"name":"correctedTreatedDocumentId","required":true,"in":"path","schema":{"type":"string"}},{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutCorrectedTreatedDocumentDto"}}}},"responses":{"200":{"description":"Corrected Treated Document resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/CorrectedTreatedDocumentEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Document"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/correctedTreatedDocuments/{correctedTreatedDocumentId}/enrich":{"post":{"operationId":"DocumentController_enrichOrganisationCorrectedTreatedDocument","summary":"Enrich a Corrected Treated Document resource and creates a Enriched Document resource.","description":"From a given user's Corrected Treated Document, a Skillberg enrichment will be proceeded and will assign skills to the resume based on the extracted jsonResume schema.\n        This will then be saved into an EnrichedDocument resource","parameters":[{"name":"correctedTreatedDocumentId","required":true,"in":"path","schema":{"type":"string"}},{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":"Enriched Document resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/EnrichedDocumentEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Document"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/enrichedDocuments/{enrichedDocumentId}/correctedEnrichedDocuments":{"post":{"operationId":"DocumentController_postOrganisationCorrectedEnrichedDocument","summary":"Creates a Corrected Enriched Document resource.","description":"With a previously given Enriched Document resource, creates a Corrected Enriched Document resource for a given user. \n      Be careful, after posting this Corrected Enriched Document you won't be able to edit it anymore","parameters":[{"name":"enrichedDocumentId","required":true,"in":"path","schema":{"type":"string"}},{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostCorrectedEnrichedDocumentDto"}}}},"responses":{"201":{"description":"Corrected Enriched Document resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/CorrectedEnrichedDocumentEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Document"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/correctedEnrichedDocuments/{correctedEnrichedDocumentId}":{"put":{"operationId":"DocumentController_putOrganisationCorrectedEnrichedDocument","summary":"Replaces a Corrected Enriched Document resource.","description":"With a Corrected Enriched Document id, replace the data linked to the id. Be careful, one the operation is done the data won't be available for reading/updating anymore","parameters":[{"name":"correctedEnrichedDocumentId","required":true,"in":"path","schema":{"type":"string"}},{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutCorrectedEnrichedDocumentDto"}}}},"responses":{"200":{"description":"Corrected Enriched Document resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/CorrectedEnrichedDocumentEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Document"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/rawDocuments/treat":{"post":{"operationId":"DocumentController_postRawDocumentAndTreat","summary":"Creates a Raw Document resource, treat it and creates a Treated Document resource.","description":"\n        With a CV in pdf given, a [jsonResume schema](https://jsonresume.org/schema) will be extracted and saved into a TreatedDocument resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"description":"Fichiers à uploader","content":{"multipart/form-data":{"schema":{"type":"object","properties":{"files":{"type":"array","items":{"type":"string","format":"binary"}}}}}}},"responses":{"201":{"description":"Treated Document resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/TreatedDocumentEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Document"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/rawDocuments/enrich":{"post":{"operationId":"DocumentController_postUserRawDocumentAndTreatAndEnrich","summary":"Creates a Raw Document resource, treat it, creates a Treated Document resource, then enrich it and creates an Enriched Document Resource.","description":"\n        With a CV in pdf given, a [jsonResume schema](https://jsonresume.org/schema) will be extracted and saved into a TreatedDocument resource.\n        Then, a Skillberg enrichment will be proceeded and will assign skills to the resume based on the extracted jsonResume schema.\n        This will then be saved into an EnrichedDocument resource","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"description":"Fichiers à uploader","content":{"multipart/form-data":{"schema":{"type":"object","properties":{"files":{"type":"array","items":{"type":"string","format":"binary"}}}}}}},"responses":{"201":{"description":"Treated Document resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/TreatedDocumentEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Document"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/treatedDocuments/{treatedDocumentId}/correctedTreatedDocuments":{"post":{"operationId":"DocumentController_postUserCorrectedTreatedDocument","summary":"Creates a Corrected Treated Document resource.","description":"With a previously given Treated Document resource, creates a Corrected Treated Document resource. \n      Be careful, after posting this Corrected Treated Document you won't be able to edit it anymore","parameters":[{"name":"treatedDocumentId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostCorrectedTreatedDocumentDto"}}}},"responses":{"201":{"description":"Corrected Treated Document resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/CorrectedTreatedDocumentEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Document"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/correctedTreatedDocuments/{correctedTreatedDocumentId}/enrich":{"post":{"operationId":"DocumentController_enrichUserCorrectedTreatedDocument","summary":"Enrich a Corrected Treated Document resource and creates a Enriched Document resource.","description":"From your Corrected Treated Document, a Skillberg enrichment will be proceeded and will assign skills to the resume based on the extracted jsonResume schema.\n        This will then be saved into an EnrichedDocument resource","parameters":[{"name":"correctedTreatedDocumentId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":"Enriched Document resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/EnrichedDocumentEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Document"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/enrichedDocuments/{enrichedDocumentId}/correctedEnrichedDocuments":{"post":{"operationId":"DocumentController_postUserCorrectedEnrichedDocument","summary":"Creates a Corrected Enriched Document resource.","parameters":[{"name":"enrichedDocumentId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostCorrectedEnrichedDocumentDto"}}}},"responses":{"201":{"description":"Corrected Enriched Document resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/CorrectedEnrichedDocumentEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Document"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/correctedTreatedDocuments/{correctedTreatedDocumentId}":{"get":{"operationId":"DocumentController_getCorrectedTreatedDocument","summary":"Retrieves a Corrected Treated Document resource.","description":"With a Corrected Treated Document id, retrieve the data linked to the id.","parameters":[{"name":"correctedTreatedDocumentId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":"Corrected Treated Document resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/CorrectedTreatedDocumentEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Document"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"DocumentController_putCorrectedTreatedDocument","summary":"Replaces a Corrected Treated Document resource.","description":"With a Corrected Treated Document id, replace the data linked to the id. Be careful, one the operation is done the data won't be available for reading/updating anymore","parameters":[{"name":"correctedTreatedDocumentId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutCorrectedTreatedDocumentDto"}}}},"responses":{"200":{"description":"Corrected Treated Document resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/CorrectedTreatedDocumentEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Document"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/correctedEnrichedDocuments/{correctedEnrichedDocumentId}":{"get":{"operationId":"DocumentController_getCorrectedEnrichedDocument","summary":"Retrieves a Corrected Enriched Document resource.","description":"With a Corrected Enriched Document id, retrieve the data linked to the id.","parameters":[{"name":"correctedEnrichedDocumentId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":"Corrected Enriched Document resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/CorrectedEnrichedDocumentEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Document"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"DocumentController_putCorrectedEnrichedDocument","summary":"Replaces a Corrected Enriched Document resource.","description":"With a Corrected Enriched Document id, replace the data linked to the id. Be careful, one the operation is done the data won't be available for reading/updating anymore","parameters":[{"name":"correctedEnrichedDocumentId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutCorrectedEnrichedDocumentDto"}}}},"responses":{"200":{"description":"Corrected Enriched Document resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/CorrectedEnrichedDocumentEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Document"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/evaluations":{"get":{"operationId":"EvaluationController_getManyByUser","summary":"Retrieves the collection of Evaluation resources.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"date","required":false,"in":"query","description":"Evaluation's date","schema":{"format":"date-time","default":"2026-06-15T08:27:55.147Z","example":"2026-06-15T08:27:55.147Z","type":"string"}},{"name":"type","required":false,"in":"query","description":"Evaluation's type","schema":{"example":"Bilan trimestriel","enum":["Bilan annuel","Bilan trimestriel","Évaluation de compétence","Debrief de projet"],"type":"string"}},{"name":"issuer_id","required":false,"in":"query","description":"Evaluation's issuer","schema":{"example":"507f1f77bcf86cd799439011","type":"string"}},{"name":"status","required":false,"in":"query","description":"Evaluation's status","schema":{"example":"draft","enum":["draft","done"],"type":"string"}},{"name":"orderBy[date]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}}],"responses":{"200":{"description":"Evaluation collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/EvaluationEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Evaluation"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/evaluations/{evaluationId}":{"get":{"operationId":"EvaluationController_getByUser","summary":"Retrieves an Evaluation resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"evaluationId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Evaluation resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/EvaluationEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Evaluation"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/evaluations":{"get":{"operationId":"EvaluationController_getManyByOrganisationByUser","summary":"Retrieves the collection of Evaluation resources.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"date","required":false,"in":"query","description":"Evaluation's date","schema":{"format":"date-time","default":"2026-06-15T08:27:55.147Z","example":"2026-06-15T08:27:55.147Z","type":"string"}},{"name":"type","required":false,"in":"query","description":"Evaluation's type","schema":{"example":"Bilan trimestriel","enum":["Bilan annuel","Bilan trimestriel","Évaluation de compétence","Debrief de projet"],"type":"string"}},{"name":"issuer_id","required":false,"in":"query","description":"Evaluation's issuer","schema":{"example":"507f1f77bcf86cd799439011","type":"string"}},{"name":"status","required":false,"in":"query","description":"Evaluation's status","schema":{"example":"draft","enum":["draft","done"],"type":"string"}},{"name":"orderBy[date]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}}],"responses":{"200":{"description":"Evaluation collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/EvaluationEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Evaluation"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"EvaluationController_post","summary":"Creates an Evaluation resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostEvaluationDto"}}}},"responses":{"201":{"description":"Evaluation resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/EvaluationEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Evaluation"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/evaluations/{evaluationId}":{"get":{"operationId":"EvaluationController_getByOrganisationByUser","summary":"Retrieves an Evaluation resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"evaluationId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Evaluation resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/EvaluationEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Evaluation"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"EvaluationController_put","summary":"Replaces an Evaluation resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"evaluationId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutEvaluationDto"}}}},"responses":{"200":{"description":"Evaluation resource updated","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/EvaluationEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Evaluation"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"EvaluationController_delete","summary":"Removes an Evaluation resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"evaluationId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Evaluation"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/jobPostings":{"get":{"operationId":"JobPostingController_getMany","summary":"Retrieves the collection of JobPosting resources.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"title","required":false,"in":"query","description":"Job title","schema":{"type":"string"}},{"name":"orderBy[title]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}}],"responses":{"200":{"description":"JobPosting collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/JobPostingEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["JobPosting"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"JobPostingController_post","summary":"Creates a JobPosting resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostOrganisationJobPostingDto"}}}},"responses":{"201":{"description":"JobPosting resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/JobPostingEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["JobPosting"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/jobPostings/{jobPostingId}":{"get":{"operationId":"JobPostingController_get","summary":"Retrieves a JobPosting resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"jobPostingId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"JobPosting resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/JobPostingEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["JobPosting"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"JobPostingController_put","summary":"Replaces a JobPosting resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"jobPostingId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutJobPostingDto"}}}},"responses":{"200":{"description":"JobPosting resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/JobPostingEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["JobPosting"],"security":[{"bearer":[]},{"api_key":[]}]},"patch":{"operationId":"JobPostingController_patch","summary":"Updates a JobPosting resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"jobPostingId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchJobPostingDto"}}}},"responses":{"200":{"description":"JobPosting resource updated","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/JobPostingEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["JobPosting"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"JobPostingController_delete","summary":"Removes a JobPosting resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"jobPostingId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"JobPosting resource deleted"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["JobPosting"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/jobPostings/{jobPostingId}/organisationJobPosting":{"get":{"operationId":"JobPostingController_getOrganisationJobPosting","summary":"Retrieves the OrganisationJobPosting link for a JobPosting.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"jobPostingId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"OrganisationJobPosting resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/OrganisationJobPostingEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["JobPosting"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"JobPostingController_putOrganisationJobPosting","summary":"Replaces the OrganisationJobPosting link for a JobPosting.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"jobPostingId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutOrganisationJobPostingDto"}}}},"responses":{"200":{"description":"OrganisationJobPosting resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/OrganisationJobPostingEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["JobPosting"],"security":[{"bearer":[]},{"api_key":[]}]},"patch":{"operationId":"JobPostingController_patchOrganisationJobPosting","summary":"Updates the OrganisationJobPosting link for a JobPosting.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"jobPostingId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchOrganisationJobPostingDto"}}}},"responses":{"200":{"description":"OrganisationJobPosting resource updated","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/OrganisationJobPostingEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["JobPosting"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/teams/{teamId}/projects/{projectId}/missions":{"get":{"operationId":"MissionController_getManyByOrganisationByTeamByProject","summary":"Retrieves the collection of Mission resources.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"teamId","required":true,"in":"path","schema":{"type":"string"}},{"name":"projectId","required":true,"in":"path","schema":{"type":"string"}},{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"name","required":false,"in":"query","schema":{"type":"string"}},{"name":"orderBy[name]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}}],"responses":{"200":{"description":"Mission collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/MissionEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Mission"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"MissionController_post","summary":"Creates a Mission resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"teamId","required":true,"in":"path","schema":{"type":"string"}},{"name":"projectId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostMissionDto"}}}},"responses":{"201":{"description":"Mission resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/MissionEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Mission"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/teams/{teamId}/projects/{projectId}/missions/{missionId}":{"get":{"operationId":"MissionController_getByOrganisationByTeamByProject","summary":"Retrieves a Mission resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"teamId","required":true,"in":"path","schema":{"type":"string"}},{"name":"projectId","required":true,"in":"path","schema":{"type":"string"}},{"name":"missionId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Mission resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/MissionEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Mission"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"MissionController_put","summary":"Replaces a Mission resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"teamId","required":true,"in":"path","schema":{"type":"string"}},{"name":"projectId","required":true,"in":"path","schema":{"type":"string"}},{"name":"missionId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutMissionDto"}}}},"responses":{"200":{"description":"Mission resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/MissionEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Mission"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"MissionController_delete","summary":"Removes a Mission resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"teamId","required":true,"in":"path","schema":{"type":"string"}},{"name":"projectId","required":true,"in":"path","schema":{"type":"string"}},{"name":"missionId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"Mission resource"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Mission"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/offers":{"get":{"operationId":"OfferController_getMany","summary":"Retrieves the collection of Offer resources.","parameters":[{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"name","required":false,"in":"query","schema":{"type":"string"}},{"name":"orderBy[name]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}}],"responses":{"200":{"description":"Offer collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/OfferEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Offer"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/offers/{offerId}":{"get":{"operationId":"OfferController_get","summary":"Retrieves an Offer resource.","parameters":[{"name":"offerId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Offer resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/OfferEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Offer"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/offers":{"get":{"operationId":"OfferController_getManyByOrganisation","summary":"Retrieves the collection of Offer resources.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"name","required":false,"in":"query","schema":{"type":"string"}},{"name":"orderBy[name]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}}],"responses":{"200":{"description":"Offer collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/OfferEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Offer"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"OfferController_postOffer","summary":"Creates an Offer resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostOfferDto"}}}},"responses":{"201":{"description":"Offer resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/OfferEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Offer"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/offers/{offerId}":{"get":{"operationId":"OfferController_getByOrganisation","summary":"Retrieves an Offer resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"offerId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Offer resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/OfferEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Offer"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"OfferController_put","summary":"Replaces an Offer resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"offerId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutOfferDto"}}}},"responses":{"200":{"description":"Offer resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/OfferEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Offer"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"OfferController_delete","summary":"Removes an Offer resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"offerId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"Offer resource deleted","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/OfferEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Offer"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/offers/{offerId}/compatibilities":{"get":{"operationId":"OfferController_getCompatibilitiesByOrganisationByOffer","summary":"Retrieves a Compatibility resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"offerId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Compatibility resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/CompatibilityResponse"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Offer"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/offers/{offerId}/offerUsers":{"get":{"operationId":"OfferUserController_getManyByOrganisationByOffer","summary":"Retrieves the collection of OfferUser resources.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"offerId","required":true,"in":"path","schema":{"type":"string"}},{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"user_id","required":false,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"OfferUser collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/OfferUserEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["OfferUser"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"OfferUserController_post","summary":"Creates a OfferUser resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"offerId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostOfferUserDto"}}}},"responses":{"201":{"description":"OfferUser resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/OfferUserEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["OfferUser"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/offers/{offerId}/offerUsers/{offerUserId}":{"get":{"operationId":"OfferUserController_getByOrganisationByOffer","summary":"Retrieves a OfferUser resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"offerId","required":true,"in":"path","schema":{"type":"string"}},{"name":"offerUserId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"OfferUser identifier","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/OfferUserEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["OfferUser"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"OfferUserController_put","summary":"Replaces a OfferUser resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"offerId","required":true,"in":"path","schema":{"type":"string"}},{"name":"offerUserId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutOfferUserDto"}}}},"responses":{"200":{"description":"OfferUser resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/OfferUserEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["OfferUser"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"OfferUserController_delete","summary":"Removes a OfferUser resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"offerId","required":true,"in":"path","schema":{"type":"string"}},{"name":"offerUserId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"OfferUser resource deleted"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["OfferUser"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations":{"get":{"operationId":"OrganisationController_getMany","summary":"Retrieves the collection of Organisation resources.","parameters":[{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"name","required":false,"in":"query","schema":{"type":"string"}},{"name":"orderBy[name]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}}],"responses":{"200":{"description":"Organisation collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/OrganisationEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Organisation"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"OrganisationController_post","summary":"Creates an Organisation resource.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostOrganisationDto"}}}},"responses":{"201":{"description":"Organisation resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/OrganisationEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Organisation"],"security":[{"bearer":[]}]}},"/v1/organisations/{organisationId}":{"get":{"operationId":"OrganisationController_get","summary":"Retrieves an Organisation resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Organisation resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/OrganisationEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Organisation"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"OrganisationController_put","summary":"Replaces an Organisation resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutOrganisationDto"}}}},"responses":{"200":{"description":"Organisation resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/OrganisationEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Organisation"],"security":[{"bearer":[]},{"api_key":[]}]},"patch":{"operationId":"OrganisationController_patch","summary":"Partially updates an Organisation resource (only the provided fields).","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchOrganisationDto"}}}},"responses":{"200":{"description":"Organisation resource updated","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/OrganisationEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Organisation"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"OrganisationController_delete","summary":"Removes an Organisation resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"Organisation resource deleted","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/OrganisationEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Organisation"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/organisations":{"get":{"operationId":"OrganisationController_getManyByUserId","summary":"Retrieves the collection of Organisation resources.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"name","required":false,"in":"query","schema":{"type":"string"}},{"name":"orderBy[name]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}}],"responses":{"200":{"description":"Organisation collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/OrganisationEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Organisation"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/organisationPlans":{"get":{"operationId":"OrganisationPlanController_getMany","summary":"Retrieves the OrganisationPlan history of an organisation (chained via previous_organisation_plan_id, ordered by creation date asc).","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"billing_cycle","required":false,"in":"query","schema":{"enum":["monthly","annual"],"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"enum":["payment_pending","active","past_due","unpaid","canceled","incomplete_expired","superseded"],"type":"string"}},{"name":"orderBy[created_at]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"orderBy[started_at]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}}],"responses":{"200":{"description":"OrganisationPlan collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/OrganisationPlanEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["OrganisationPlans"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/organisationPlans/current":{"get":{"operationId":"OrganisationPlanController_getCurrent","summary":"Retrieves the active OrganisationPlan (the one with ended_at = null). 404 if no maillon courant exists yet.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Current OrganisationPlan","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/OrganisationPlanEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["OrganisationPlans"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/organisationPlans/{organisationPlanId}":{"get":{"operationId":"OrganisationPlanController_getOne","summary":"Retrieves a single OrganisationPlan by ID.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"organisationPlanId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"OrganisationPlan","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/OrganisationPlanEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["OrganisationPlans"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/organisationPlans/dev-checkout":{"post":{"operationId":"OrganisationPlanController_devCheckout","summary":"Dev-only : simule un checkout Stripe réussi (crée un nouveau maillon, supersede l'ancien). 403 en production.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DevCheckoutDto"}}}},"responses":{"201":{"description":"Newly created OrganisationPlan","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/OrganisationPlanEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["OrganisationPlans"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/organisationPlans/downgrade-to-free":{"post":{"operationId":"OrganisationPlanController_downgradeToFree","summary":"Switches the organisation to a free plan (Discovery today). Rejects with 400 if the target plan is paid — the only way to land on a paid plan is via the Mollie checkout flow.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DowngradeToFreeDto"}}}},"responses":{"201":{"description":"Newly created free OrganisationPlan","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/OrganisationPlanEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["OrganisationPlans"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/payment-organisation":{"get":{"operationId":"PaymentOrganisationController_getOne","summary":"Get the billing identity (legal_name, siret, billing_email, billing_address, payment provider/customer) for an organisation. Returns 404 if no billing identity has been set up yet — that is a normal state for fresh orgs.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"PaymentOrganisation record","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/PaymentOrganisationEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["PaymentOrganisation"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"PaymentOrganisationController_put","summary":"Replace the billing identity for an organisation (legal_name, siret, billing_email, billing_address). Upserts on first call — the row is created lazily. Does not touch payment_provider / payment_customer_id; those are managed by the internal link-mollie-customer route.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutPaymentOrganisationDto"}}}},"responses":{"200":{"description":"Upserted PaymentOrganisation","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/PaymentOrganisationEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["PaymentOrganisation"],"security":[{"bearer":[]},{"api_key":[]}]},"patch":{"operationId":"PaymentOrganisationController_patch","summary":"Patch the billing identity for an organisation. Same upsert primitive as PUT — unset fields stay untouched.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchPaymentOrganisationDto"}}}},"responses":{"200":{"description":"Upserted PaymentOrganisation","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/PaymentOrganisationEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["PaymentOrganisation"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/plans":{"get":{"operationId":"PlanController_getMany","summary":"Retrieves the collection of Plan resources.","parameters":[{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"code","required":false,"in":"query","schema":{"enum":["discovery","builder","scale","partner","omni"],"type":"string"}},{"name":"is_public","required":false,"in":"query","schema":{"type":"boolean"}},{"name":"orderBy[sort_order]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"orderBy[price_monthly_eur]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}}],"responses":{"200":{"description":"Plan collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/PlanEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Plans"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/plans/public":{"get":{"operationId":"PlanController_getPublic","summary":"Lists publicly-visible plans for the marketing site. No authentication required. Returns pricing-safe fields only (no route_access).","parameters":[],"responses":{"200":{"description":"Marketing-safe plan list","content":{"application/ld+json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PublicPlanDto"}}}}}},"tags":["Plans"]}},"/v1/plans/{code}":{"get":{"operationId":"PlanController_getOne","summary":"Retrieves a Plan resource by code.","parameters":[{"name":"code","required":true,"in":"path","description":"Plan code","schema":{"enum":["discovery","builder","scale","partner","omni"],"type":"string"}}],"responses":{"200":{"description":"Plan resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/PlanEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Plans"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/programs":{"get":{"operationId":"ProgramController_getManyByOrganisation","summary":"Retrieves the collection of Program resources.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"name","required":false,"in":"query","schema":{"type":"string"}},{"name":"orderBy[name]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}}],"responses":{"200":{"description":"Program collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/ProgramEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Program"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"ProgramController_postProgram","summary":"Creates a Program resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostProgramDto"}}}},"responses":{"201":{"description":"Program resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/ProgramEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Program"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/programs/{programId}":{"get":{"operationId":"ProgramController_getByOrganisation","summary":"Retrieves a Program resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"programId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Program resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/ProgramEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Program"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"ProgramController_put","summary":"Replaces a Program resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"programId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutProgramDto"}}}},"responses":{"200":{"description":"Program resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/ProgramEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Program"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"ProgramController_delete","summary":"Removes a Program resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"programId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"Program resource deleted"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Program"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/teams/{teamId}/projects":{"get":{"operationId":"ProjectController_getManyByOrganisationByTeam","summary":"Retrieves the collection of Project resources.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"teamId","required":true,"in":"path","schema":{"type":"string"}},{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"name","required":false,"in":"query","schema":{"type":"string"}},{"name":"orderBy[name]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}}],"responses":{"200":{"description":"Project collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/ProjectEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Project"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"ProjectController_post","summary":"Creates a Project resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"teamId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostProjectDto"}}}},"responses":{"201":{"description":"Project resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/ProjectEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Project"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/teams/{teamId}/projects/{projectId}":{"get":{"operationId":"ProjectController_getByOrganisationByTeam","summary":"Retrieves a Project resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"teamId","required":true,"in":"path","schema":{"type":"string"}},{"name":"projectId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Project resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/ProjectEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Project"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"ProjectController_put","summary":"Replaces a Project resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"teamId","required":true,"in":"path","schema":{"type":"string"}},{"name":"projectId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutProjectDto"}}}},"responses":{"200":{"description":"Project resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/ProjectEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Project"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"ProjectController_delete","summary":"Removes a Project resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"teamId","required":true,"in":"path","schema":{"type":"string"}},{"name":"projectId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"Project resource"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Project"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/credits":{"get":{"operationId":"AccountController_getCredits","summary":"Get the calling API key's credit balance","parameters":[],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountCreditsResponse"}}}}},"tags":["Public API — Account"]}},"/v1/parse/cv":{"post":{"operationId":"parseCv","summary":"Parse a CV into structured skills, experience, education.","parameters":[],"requestBody":{"required":true,"description":"Fichier à uploader","content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"}}}}}},"responses":{"200":{"description":"Parsed CV"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"501":{"description":""}},"tags":["Public API — Analyse"],"security":[{"api_key":[]}]}},"/v1/parse/job-offer":{"post":{"operationId":"parseJobOffer","summary":"Parse a job offer into required/desired skills.","parameters":[],"requestBody":{"required":true,"description":"Fichier à uploader","content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"}}}}}},"responses":{"200":{"description":"Parsed job offer"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"501":{"description":""}},"tags":["Public API — Analyse"],"security":[{"api_key":[]}]}},"/v1/skills/extract":{"post":{"operationId":"skillsExtract","summary":"Full skill profile of an occupation (essential/optional).","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillsExtractRequestDto"}}}},"responses":{"200":{"description":"Skill profile"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"501":{"description":""}},"tags":["Public API — Analyse"],"security":[{"api_key":[]}]}},"/v1/skills/recommend":{"post":{"operationId":"skillsRecommend","summary":"Recommend relevant skills via knowledge-graph intelligence.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillsRecommendRequestDto"}}}},"responses":{"200":{"description":"Recommended skills"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"501":{"description":""}},"tags":["Public API — Analyse"],"security":[{"api_key":[]}]}},"/v1/cv/score":{"post":{"operationId":"cvScore","summary":"Score a CV: composite quality score + improvement axes.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CvScoreRequestDto"}}}},"responses":{"200":{"description":"CV score"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"501":{"description":""}},"tags":["Public API — Analyse"],"security":[{"api_key":[]}]}},"/v1/search/skill":{"get":{"operationId":"searchSkill","summary":"Search skills by keyword or associated occupation.","parameters":[{"name":"q","required":true,"in":"query","description":"Free-text search query","schema":{"example":"Python","type":"string"}},{"name":"limit","required":false,"in":"query","schema":{"minimum":1,"maximum":100,"default":20,"type":"number"}},{"name":"threshold","required":false,"in":"query","schema":{"minimum":0,"maximum":1,"default":0.1,"type":"number"}}],"responses":{"200":{"description":"Matching skills ranked by cosine similarity","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/SkillSearchResponse"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"503":{"description":""}},"tags":["Public API — Consultation"],"security":[{"api_key":[]}]}},"/v1/search/occupation":{"get":{"operationId":"searchOccupation","summary":"Search occupations by keyword, sector, framework or ISCO id.","parameters":[{"name":"q","required":true,"in":"query","description":"Free-text search query","schema":{"example":"data analyst","type":"string"}},{"name":"limit","required":false,"in":"query","schema":{"minimum":1,"maximum":100,"default":20,"type":"number"}}],"responses":{"200":{"description":"Matching occupations"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"501":{"description":""}},"tags":["Public API — Consultation"],"security":[{"api_key":[]}]}},"/v1/search/sector":{"get":{"operationId":"searchSector","summary":"Browse activity sectors / ISCO groups by framework.","parameters":[{"name":"q","required":true,"in":"query","description":"Free-text search query","schema":{"example":"data analyst","type":"string"}},{"name":"limit","required":false,"in":"query","schema":{"minimum":1,"maximum":100,"default":20,"type":"number"}}],"responses":{"200":{"description":"Sector catalogue"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"501":{"description":""}},"tags":["Public API — Consultation"],"security":[{"api_key":[]}]}},"/v1/taxonomy/browse":{"get":{"operationId":"taxonomyBrowse","summary":"Navigate the multi-framework taxonomy with cross-references.","parameters":[{"name":"uri","required":false,"in":"query","description":"Parent node URI to expand; omit for taxonomy roots","schema":{"example":"skillberg://occupation/2511","type":"string"}},{"name":"framework","required":false,"in":"query","description":"Framework to browse (ESCO, ROME, ONET, SSF...)","schema":{"example":"ESCO","type":"string"}}],"responses":{"200":{"description":"Taxonomy nodes"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"501":{"description":""}},"tags":["Public API — Consultation"],"security":[{"api_key":[]}]}},"/v1/mapping/crosswalk":{"get":{"operationId":"crosswalk","summary":"Map a node across référentiels (ESCO, ROME, O*NET, Singapore, KLDB, ONS).","parameters":[{"name":"uri","required":true,"in":"query","description":"Source node URI to map","schema":{"example":"skillberg://occupation/2511","type":"string"}},{"name":"target_taxonomy","required":true,"in":"query","description":"Target taxonomy (ESCO, ROME, ONET, SSF, KLDB, ONS)","schema":{"example":"ROME","type":"string"}}],"responses":{"200":{"description":"Crosswalk correspondences"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"501":{"description":""}},"tags":["Public API — Consultation"],"security":[{"api_key":[]}]}},"/v1/match/occupation":{"post":{"operationId":"matchOccupation","summary":"Match a job title cross-framework (ESCO/ROME/O*NET).","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MatchOccupationRequestDto"}}}},"responses":{"200":{"description":"Occupation matches"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"501":{"description":""}},"tags":["Public API — Intelligence"],"security":[{"api_key":[]}]}},"/v1/enrich/job-offer":{"post":{"operationId":"enrichJobOffer","summary":"Enrich a job offer: parsing + implicit skill inference.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnrichJobOfferRequestDto"}}}},"responses":{"200":{"description":"Enriched job offer"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"500":{"description":"Internal Server Error","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Public API — Intelligence"],"security":[{"api_key":[]}]}},"/v1/enrich/cv":{"post":{"operationId":"enrichCv","summary":"Enrich a CV: parsing + implicit skill inference (knowledge graph).","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnrichCvRequestDto"}}}},"responses":{"200":{"description":"Enriched CV (json_resume)"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"500":{"description":"Internal Server Error","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Public API — Intelligence"],"security":[{"api_key":[]}]}},"/v1/match/cvs-vs-job":{"post":{"operationId":"matchCvsVsJob","summary":"Reverse matching: one job vs a pool of pre-indexed CVs.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MatchCvsVsJobRequestDto"}}}},"responses":{"200":{"description":"Ranked CVs"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"501":{"description":""}},"tags":["Public API — Intelligence"],"security":[{"api_key":[]}]}},"/v1/match/jobs-vs-cv":{"post":{"operationId":"matchJobsVsCv","summary":"Reverse matching: one CV vs a pool of pre-indexed jobs.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MatchJobsVsCvRequestDto"}}}},"responses":{"200":{"description":"Ranked jobs"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"501":{"description":""}},"tags":["Public API — Intelligence"],"security":[{"api_key":[]}]}},"/v1/skills/gap":{"post":{"operationId":"skillsGap","summary":"Gap analysis: missing skills + training-time estimate.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillsGapRequestDto"}}}},"responses":{"200":{"description":"Skill gap"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"501":{"description":""}},"tags":["Public API — Intelligence"],"security":[{"api_key":[]}]}},"/v1/workforce/map":{"post":{"operationId":"workforceMap","summary":"Bulk-map a full job architecture to a target framework. (Beta)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkforceMapRequestDto"}}}},"responses":{"200":{"description":"Workforce map"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"501":{"description":""}},"tags":["Public API — Intelligence"],"security":[{"api_key":[]}]}},"/v1/career/transitions":{"post":{"operationId":"careerTransitions","summary":"Career pathways: transitions with % shared skills. (Beta)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CareerTransitionsRequestDto"}}}},"responses":{"200":{"description":"Career transitions"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"501":{"description":""}},"tags":["Public API — Intelligence"],"security":[{"api_key":[]}]}},"/v1/roles":{"get":{"operationId":"RoleController_getMany","summary":"Retrieves the collection of Role resources.","parameters":[{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"name","required":false,"in":"query","schema":{"type":"string"}},{"name":"orderBy[name]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}}],"responses":{"200":{"description":"Role collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/RoleEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Roles"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/sessions":{"get":{"operationId":"SessionController_getManyByOrganisation","summary":"Retrieves the collection of Session resources.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"name","required":false,"in":"query","schema":{"type":"string"}},{"name":"orderBy[name]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}}],"responses":{"200":{"description":"Session collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/SessionEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Session"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"SessionController_postSession","summary":"Creates a Session resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostSessionDto"}}}},"responses":{"201":{"description":"Session resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/SessionEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Session"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/sessions/{sessionId}":{"get":{"operationId":"SessionController_getByOrganisation","summary":"Retrieves a Session resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"sessionId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Session resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/SessionEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Session"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"SessionController_put","summary":"Replaces a Session resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"sessionId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutSessionDto"}}}},"responses":{"200":{"description":"Session resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/SessionEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Session"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"SessionController_delete","summary":"Removes a Session resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"sessionId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"Session resource deleted"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Session"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/SkillbergAIs/skills/search":{"get":{"operationId":"search","summary":"Semantic search across the Skillberg knowledge graph skills.","parameters":[{"name":"q","required":true,"in":"query","description":"Free-text search query","schema":{"example":"Python","type":"string"}},{"name":"limit","required":false,"in":"query","schema":{"minimum":1,"maximum":100,"default":20,"type":"number"}},{"name":"threshold","required":false,"in":"query","schema":{"minimum":0,"maximum":1,"default":0.1,"type":"number"}}],"responses":{"200":{"description":"Matching skills ranked by cosine similarity","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/SkillSearchResponse"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"503":{"description":""}},"tags":["SkillbergAI"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/SkillbergAIs/skills/{skill_uuid}":{"get":{"operationId":"getSkill","summary":"Get a skill entity by its Skillberg UUID.","parameters":[{"name":"skill_uuid","required":true,"in":"path","description":"Skill UUID in the Skillberg knowledge graph","schema":{"type":"string"}}],"responses":{"200":{"description":"Skill entity","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/SkillEntityDto"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"503":{"description":""}},"tags":["SkillbergAI"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/skillSets/{skillSetId}":{"get":{"operationId":"SkillSetController_get","summary":"Retrieves a SkillSet resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"skillSetId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"SkillSet resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/SkillSetEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["SkillSet"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"SkillSetController_put","summary":"Replaces a SkillSet resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"skillSetId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutSkillSetDto"}}}},"responses":{"200":{"description":"SkillSet resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/SkillSetEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["SkillSet"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/skillSets":{"post":{"operationId":"SkillSetController_postUserSkillSet","summary":"Creates a SkillSet resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostSkillSetDto"}}}},"responses":{"201":{"description":"SkillSet resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/SkillSetEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["SkillSet"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/offers/{offerId}/skillSets":{"post":{"operationId":"SkillSetController_postOfferSkillSet","summary":"Creates a SkillSet resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"offerId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostSkillSetDto"}}}},"responses":{"201":{"description":"SkillSet resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/SkillSetEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["SkillSet"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/sonarUser":{"get":{"operationId":"SonarUserController_getByUser","summary":"Retrieves the Sonar-specific profile for a user. Lazy-creates the document on first read so its created_at marks the user's first contact with Sonar.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"SonarUser resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/SonarUserEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["SonarUser"],"security":[{"bearer":[]},{"api_key":[]}]},"patch":{"operationId":"SonarUserController_patch","summary":"Updates the Sonar-specific profile for a user (onboarded_at, role).","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchSonarUserDto"}}}},"responses":{"200":{"description":"SonarUser resource updated","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/SonarUserEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["SonarUser"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/teams":{"get":{"operationId":"TeamController_getManyByOrganisationByUser","summary":"Retrieves the collection of Team resources.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"name","required":false,"in":"query","schema":{"type":"string"}},{"name":"orderBy[name]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}}],"responses":{"200":{"description":"Team collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/TeamEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Team"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/teams":{"get":{"operationId":"TeamController_getManyByOrganisation","summary":"Retrieves the collection of Team resources.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"name","required":false,"in":"query","schema":{"type":"string"}},{"name":"orderBy[name]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}}],"responses":{"200":{"description":"Team collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/TeamEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Team"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"TeamController_post","summary":"Creates a Team resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostTeamDto"}}}},"responses":{"201":{"description":"Team resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/TeamEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Team"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/teams/{teamId}":{"get":{"operationId":"TeamController_getByOrganisation","summary":"Retrieves a Team resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"teamId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Team resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/TeamEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Team"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"TeamController_put","summary":"Replaces a Team resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"teamId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutTeamDto"}}}},"responses":{"200":{"description":"Team resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/TeamEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Team"],"security":[{"bearer":[]},{"api_key":[]}]},"patch":{"operationId":"TeamController_patch","summary":"Updates a Team resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"teamId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchTeamDto"}}}},"responses":{"200":{"description":"Team resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/TeamEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Team"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"TeamController_delete","summary":"Removes a Team resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"teamId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"Team resource"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Team"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/usage/summary":{"get":{"operationId":"UsageController_getSummary","summary":"Aggregated usage summary for an organisation in the given time window. Defaults to the last 30 days.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"from","required":false,"in":"query","description":"Start of the window (ISO-8601). Defaults to 30 days before `to`.","schema":{"format":"date-time","type":"string"}},{"name":"to","required":false,"in":"query","description":"End of the window (ISO-8601, exclusive). Defaults to now.","schema":{"format":"date-time","type":"string"}}],"responses":{"200":{"description":"Usage summary","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UsageSummaryDto"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Usage"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/usage/daily":{"get":{"operationId":"UsageController_getDaily","summary":"Daily usage breakdown (calls + credits per day) for an organisation. Defaults to the last 30 days.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"from","required":false,"in":"query","description":"Start of the window (ISO-8601). Defaults to 30 days before `to`.","schema":{"format":"date-time","type":"string"}},{"name":"to","required":false,"in":"query","description":"End of the window (ISO-8601, exclusive). Defaults to now.","schema":{"format":"date-time","type":"string"}},{"name":"tz","required":false,"in":"query","description":"IANA timezone for day bucketing (e.g. \"Europe/Paris\"). Defaults to UTC.","schema":{"default":"UTC","type":"string"}}],"responses":{"200":{"description":"Daily usage entries","content":{"application/ld+json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/UsageDailyEntryDto"}}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Usage"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/usage/top-routes":{"get":{"operationId":"UsageController_getTopRoutes","summary":"Top API routes by call volume for an organisation in the given time window. Defaults to top 5 over the last 30 days.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"from","required":false,"in":"query","description":"Start of the window (ISO-8601). Defaults to 30 days before `to`.","schema":{"format":"date-time","type":"string"}},{"name":"to","required":false,"in":"query","description":"End of the window (ISO-8601, exclusive). Defaults to now.","schema":{"format":"date-time","type":"string"}},{"name":"limit","required":false,"in":"query","description":"Maximum number of routes to return (1..50).","schema":{"default":5,"type":"number"}}],"responses":{"200":{"description":"Top routes by volume","content":{"application/ld+json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/UsageTopRouteDto"}}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Usage"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/usage/by-key":{"get":{"operationId":"UsageController_getByKey","summary":"Usage grouped by ApiKey for an organisation in the given window. Returns an entry per key that had at least one call. Sorted by credits desc.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"from","required":false,"in":"query","description":"Start of the window (ISO-8601). Defaults to 30 days before `to`.","schema":{"format":"date-time","type":"string"}},{"name":"to","required":false,"in":"query","description":"End of the window (ISO-8601, exclusive). Defaults to now.","schema":{"format":"date-time","type":"string"}}],"responses":{"200":{"description":"Per-key usage breakdown","content":{"application/ld+json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/UsageByKeyEntryDto"}}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Usage"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/usage/by-family":{"get":{"operationId":"UsageController_getByFamily","summary":"Usage grouped by route family (consultation/analyse/intelligence). Sorted by credits desc. Defaults to the last 30 days.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"from","required":false,"in":"query","description":"Start of the window (ISO-8601). Defaults to 30 days before `to`.","schema":{"format":"date-time","type":"string"}},{"name":"to","required":false,"in":"query","description":"End of the window (ISO-8601, exclusive). Defaults to now.","schema":{"format":"date-time","type":"string"}}],"responses":{"200":{"description":"Per-family usage breakdown","content":{"application/ld+json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/UsageByFamilyEntryDto"}}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["Usage"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users":{"get":{"operationId":"UserController_getMany","summary":"Retrieves the collection of User resources.","parameters":[{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"email","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"name","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"surname","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"username","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"date_of_birth","required":false,"in":"query","schema":{"format":"date-time","nullable":true,"type":"string"}},{"name":"orderBy[name]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"orderBy[surname]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"orderBy[username]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"orderBy[email]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"skillSet_id","required":false,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"User collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/UserEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["User"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"UserController_post","summary":"Creates a User resource.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostUserDto"}}}},"responses":{"201":{"description":"User resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["User"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}":{"get":{"operationId":"UserController_get","summary":"Retrieves a User resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"User resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["User"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"UserController_put","summary":"Replaces a User resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutUserDto"}}}},"responses":{"200":{"description":"User resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["User"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"UserController_delete","summary":"Removes a User resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"User resource deleted"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["User"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users":{"get":{"operationId":"UserController_getManyByOrganisation","summary":"Retrieves the collection of User resources.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"email","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"name","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"surname","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"username","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"date_of_birth","required":false,"in":"query","schema":{"format":"date-time","nullable":true,"type":"string"}},{"name":"orderBy[name]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"orderBy[surname]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"orderBy[username]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"orderBy[email]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"skillSet_id","required":false,"in":"query","schema":{"type":"string"}},{"name":"role_id_list","required":false,"in":"query","schema":{"type":"array","items":{"type":"string"}}},{"name":"user_id","required":false,"in":"query","schema":{"type":"array","items":{"type":"string"}}}],"responses":{"200":{"description":"User collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/UserEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["User"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"UserController_postUser","summary":"Creates a User resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostUserDto"}}}},"responses":{"201":{"description":"User resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["User"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/teams/{teamId}/users":{"get":{"operationId":"UserController_getManyByOrganisationByTeam","summary":"Retrieves the collection of User resources.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"teamId","required":true,"in":"path","schema":{"type":"string"}},{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"email","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"name","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"surname","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"username","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"date_of_birth","required":false,"in":"query","schema":{"format":"date-time","nullable":true,"type":"string"}},{"name":"orderBy[name]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"orderBy[surname]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"orderBy[username]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"orderBy[email]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"skillSet_id","required":false,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"User collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/UserEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["User"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/offers/{offerId}/users":{"get":{"operationId":"UserController_getManyByOrganisationByOffer","summary":"Retrieves the collection of User resources.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"offerId","required":true,"in":"path","schema":{"type":"string"}},{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"email","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"name","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"surname","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"username","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"date_of_birth","required":false,"in":"query","schema":{"format":"date-time","nullable":true,"type":"string"}},{"name":"orderBy[name]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"orderBy[surname]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"orderBy[username]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"orderBy[email]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"skillSet_id","required":false,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"User collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/UserEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["User"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/jobs/{jobId}/matching":{"post":{"operationId":"UserController_generateMatchingScore","summary":"Generates a matching score between users and a job.","parameters":[{"name":"jobId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsersToCompareDto"}}}},"responses":{"201":{"description":"Matching score generated","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/MatchingScoreResponse"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["User"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/completion":{"post":{"operationId":"UserController_generateCompletionScore","summary":"Generates a completion score for a given user.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompletionWeightsDto"}}}},"responses":{"201":{"description":"Completion score generated","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/CompletionScoreResponse"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["User"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/awards":{"get":{"operationId":"UserAwardController_getManyByUser","summary":"Retrieves the collection of UserAward resources.","parameters":[{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"title","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"awarder","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"orderBy[title]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"orderBy[awarder]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserAward collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/UserAwardEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserAward"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"UserAwardController_post","summary":"Creates a UserAward resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostUserAwardDto"}}}},"responses":{"201":{"description":"UserAward resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserAwardEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserAward"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/awards/{awardId}":{"get":{"operationId":"UserAwardController_getByUser","summary":"Retrieves a UserAward resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"awardId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserAward resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserAwardEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserAward"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"UserAwardController_put","summary":"Replaces a UserAward resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"awardId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutUserAwardDto"}}}},"responses":{"200":{"description":"UserAward resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserAwardEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserAward"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"UserAwardController_delete","summary":"Removes a UserAward resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"awardId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"UserAward resource deleted"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserAward"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/awards":{"get":{"operationId":"UserAwardController_getManyFromOrganisation","summary":"Retrieves the collection of UserAward resources.","parameters":[{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"title","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"awarder","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"orderBy[title]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"orderBy[awarder]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserAward collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/UserAwardEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserAward"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"UserAwardController_postFromOrganisation","summary":"Creates a UserAward resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostUserAwardDto"}}}},"responses":{"201":{"description":"UserAward resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserAwardEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserAward"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/awards/{awardId}":{"get":{"operationId":"UserAwardController_getFromOrganisation","summary":"Retrieves a UserAward resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"awardId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserAward resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserAwardEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserAward"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"UserAwardController_putFromOrganisation","summary":"Replaces a UserAward resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"awardId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutUserAwardDto"}}}},"responses":{"200":{"description":"UserAward resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserAwardEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserAward"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"UserAwardController_deleteFromOrganisation","summary":"Removes a UserAward resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"awardId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"UserAward resource deleted"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserAward"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/educations":{"get":{"operationId":"UserEducationController_getManyByUser","summary":"Retrieves the collection of UserEducation resources.","parameters":[{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"institution","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"studyType","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"orderBy[institution]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"orderBy[studyType]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserEducation collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/UserEducationEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserEducation"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"UserEducationController_post","summary":"Creates a UserEducation resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostUserEducationDto"}}}},"responses":{"201":{"description":"UserEducation resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserEducationEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserEducation"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/educations/{educationId}":{"get":{"operationId":"UserEducationController_getByUser","summary":"Retrieves a UserEducation resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"educationId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserEducation resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserEducationEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserEducation"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"UserEducationController_put","summary":"Replaces a UserEducation resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"educationId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutUserEducationDto"}}}},"responses":{"200":{"description":"UserEducation resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserEducationEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserEducation"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"UserEducationController_delete","summary":"Removes a UserEducation resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"educationId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"UserEducation resource deleted"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserEducation"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/educations":{"get":{"operationId":"UserEducationController_getManyFromOrganisation","summary":"Retrieves the collection of UserEducation resources.","parameters":[{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"institution","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"studyType","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"orderBy[institution]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"orderBy[studyType]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserEducation collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/UserEducationEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserEducation"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"UserEducationController_postFromOrganisation","summary":"Creates a UserEducation resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostUserEducationDto"}}}},"responses":{"201":{"description":"UserEducation resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserEducationEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserEducation"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/educations/{educationId}":{"get":{"operationId":"UserEducationController_getFromOrganisation","summary":"Retrieves a UserEducation resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"educationId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserEducation resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserEducationEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserEducation"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"UserEducationController_putFromOrganisation","summary":"Replaces a UserEducation resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"educationId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutUserEducationDto"}}}},"responses":{"200":{"description":"UserEducation resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserEducationEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserEducation"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"UserEducationController_deleteFromOrganisation","summary":"Removes a UserEducation resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"educationId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"UserEducation resource deleted"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserEducation"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/interests":{"get":{"operationId":"UserInterestController_getManyByUser","summary":"Retrieves the collection of UserInterest resources.","parameters":[{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"name","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"orderBy[name]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserInterest collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/UserInterestEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserInterest"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"UserInterestController_post","summary":"Creates a UserInterest resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostUserInterestDto"}}}},"responses":{"201":{"description":"UserInterest resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserInterestEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserInterest"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/interests/{interestId}":{"get":{"operationId":"UserInterestController_getByUser","summary":"Retrieves a UserInterest resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"interestId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserInterest resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserInterestEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserInterest"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"UserInterestController_put","summary":"Replaces a UserInterest resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"interestId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutUserInterestDto"}}}},"responses":{"200":{"description":"UserInterest resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserInterestEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserInterest"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"UserInterestController_delete","summary":"Removes a UserInterest resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"interestId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"UserInterest resource deleted"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserInterest"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/interests":{"get":{"operationId":"UserInterestController_getManyFromOrganisation","summary":"Retrieves the collection of UserInterest resources.","parameters":[{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"name","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"orderBy[name]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserInterest collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/UserInterestEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserInterest"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"UserInterestController_postFromOrganisation","summary":"Creates a UserInterest resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostUserInterestDto"}}}},"responses":{"201":{"description":"UserInterest resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserInterestEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserInterest"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/interests/{interestId}":{"get":{"operationId":"UserInterestController_getFromOrganisation","summary":"Retrieves a UserInterest resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"interestId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserInterest resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserInterestEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserInterest"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"UserInterestController_putFromOrganisation","summary":"Replaces a UserInterest resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"interestId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutUserInterestDto"}}}},"responses":{"200":{"description":"UserInterest resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserInterestEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserInterest"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"UserInterestController_deleteFromOrganisation","summary":"Removes a UserInterest resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"interestId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"UserInterest resource deleted"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserInterest"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/languages":{"get":{"operationId":"UserLanguageController_getManyByUser","summary":"Retrieves the collection of UserLanguage resources.","parameters":[{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"language","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"fluency","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"orderBy[language]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"orderBy[fluency]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserLanguage collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/UserLanguageEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserLanguage"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"UserLanguageController_post","summary":"Creates a UserLanguage resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostUserLanguageDto"}}}},"responses":{"201":{"description":"UserLanguage resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserLanguageEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserLanguage"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/languages/{languageId}":{"get":{"operationId":"UserLanguageController_getByUser","summary":"Retrieves a UserLanguage resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"languageId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserLanguage resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserLanguageEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserLanguage"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"UserLanguageController_put","summary":"Replaces a UserLanguage resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"languageId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutUserLanguageDto"}}}},"responses":{"200":{"description":"UserLanguage resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserLanguageEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserLanguage"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"UserLanguageController_delete","summary":"Removes a UserLanguage resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"languageId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"UserLanguage resource deleted"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserLanguage"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/languages":{"get":{"operationId":"UserLanguageController_getManyFromOrganisation","summary":"Retrieves the collection of UserLanguage resources.","parameters":[{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"language","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"fluency","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"orderBy[language]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"orderBy[fluency]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserLanguage collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/UserLanguageEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserLanguage"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"UserLanguageController_postFromOrganisation","summary":"Creates a UserLanguage resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostUserLanguageDto"}}}},"responses":{"201":{"description":"UserLanguage resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserLanguageEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserLanguage"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/languages/{languageId}":{"get":{"operationId":"UserLanguageController_getFromOrganisation","summary":"Retrieves a UserLanguage resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"languageId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserLanguage resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserLanguageEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserLanguage"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"UserLanguageController_putFromOrganisation","summary":"Replaces a UserLanguage resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"languageId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutUserLanguageDto"}}}},"responses":{"200":{"description":"UserLanguage resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserLanguageEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserLanguage"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"UserLanguageController_deleteFromOrganisation","summary":"Removes a UserLanguage resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"languageId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"UserLanguage resource deleted"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserLanguage"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/projects":{"get":{"operationId":"UserProjectController_getManyByUser","summary":"Retrieves the collection of UserProject resources.","parameters":[{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"name","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"description","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"orderBy[name]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"orderBy[description]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserProject collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/UserProjectEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserProject"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"UserProjectController_post","summary":"Creates a UserProject resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostUserProjectDto"}}}},"responses":{"201":{"description":"UserProject resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserProjectEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserProject"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/projects/{projectId}":{"get":{"operationId":"UserProjectController_getByUser","summary":"Retrieves a UserProject resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"projectId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserProject resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserProjectEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserProject"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"UserProjectController_put","summary":"Replaces a UserProject resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"projectId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutUserProjectDto"}}}},"responses":{"200":{"description":"UserProject resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserProjectEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserProject"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"UserProjectController_delete","summary":"Removes a UserProject resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"projectId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"UserProject resource deleted"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserProject"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/projects":{"get":{"operationId":"UserProjectController_getManyFromOrganisation","summary":"Retrieves the collection of UserProject resources.","parameters":[{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"name","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"description","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"orderBy[name]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"orderBy[description]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserProject collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/UserProjectEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserProject"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"UserProjectController_postFromOrganisation","summary":"Creates a UserProject resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostUserProjectDto"}}}},"responses":{"201":{"description":"UserProject resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserProjectEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserProject"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/projects/{projectId}":{"get":{"operationId":"UserProjectController_getFromOrganisation","summary":"Retrieves a UserProject resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"projectId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserProject resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserProjectEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserProject"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"UserProjectController_putFromOrganisation","summary":"Replaces a UserProject resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"projectId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutUserProjectDto"}}}},"responses":{"200":{"description":"UserProject resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserProjectEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserProject"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"UserProjectController_deleteFromOrganisation","summary":"Removes a UserProject resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"projectId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"UserProject resource deleted"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserProject"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/publications":{"get":{"operationId":"UserPublicationController_getManyByUser","summary":"Retrieves the collection of UserPublication resources.","parameters":[{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"name","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"publisher","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"orderBy[name]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"orderBy[publisher]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserPublication collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/UserPublicationEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserPublication"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"UserPublicationController_post","summary":"Creates a UserPublication resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostUserPublicationDto"}}}},"responses":{"201":{"description":"UserPublication resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserPublicationEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserPublication"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/publications/{publicationId}":{"get":{"operationId":"UserPublicationController_getByUser","summary":"Retrieves a UserPublication resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"publicationId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserPublication resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserPublicationEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserPublication"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"UserPublicationController_put","summary":"Replaces a UserPublication resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"publicationId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutUserPublicationDto"}}}},"responses":{"200":{"description":"UserPublication resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserPublicationEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserPublication"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"UserPublicationController_delete","summary":"Removes a UserPublication resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"publicationId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"UserPublication resource deleted"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserPublication"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/publications":{"get":{"operationId":"UserPublicationController_getManyFromOrganisation","summary":"Retrieves the collection of UserPublication resources.","parameters":[{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"name","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"publisher","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"orderBy[name]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"orderBy[publisher]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserPublication collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/UserPublicationEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserPublication"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"UserPublicationController_postFromOrganisation","summary":"Creates a UserPublication resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostUserPublicationDto"}}}},"responses":{"201":{"description":"UserPublication resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserPublicationEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserPublication"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/publications/{publicationId}":{"get":{"operationId":"UserPublicationController_getFromOrganisation","summary":"Retrieves a UserPublication resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"publicationId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserPublication resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserPublicationEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserPublication"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"UserPublicationController_putFromOrganisation","summary":"Replaces a UserPublication resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"publicationId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutUserPublicationDto"}}}},"responses":{"200":{"description":"UserPublication resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserPublicationEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserPublication"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"UserPublicationController_deleteFromOrganisation","summary":"Removes a UserPublication resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"publicationId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"UserPublication resource deleted"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserPublication"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/references":{"get":{"operationId":"UserReferenceController_getManyByUser","summary":"Retrieves the collection of UserReference resources.","parameters":[{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"name","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"orderBy[name]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserReference collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/UserReferenceEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserReference"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"UserReferenceController_post","summary":"Creates a UserReference resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostUserReferenceDto"}}}},"responses":{"201":{"description":"UserReference resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserReferenceEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserReference"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/references/{referenceId}":{"get":{"operationId":"UserReferenceController_getByUser","summary":"Retrieves a UserReference resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"referenceId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserReference resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserReferenceEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserReference"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"UserReferenceController_put","summary":"Replaces a UserReference resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"referenceId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutUserReferenceDto"}}}},"responses":{"200":{"description":"UserReference resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserReferenceEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserReference"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"UserReferenceController_delete","summary":"Removes a UserReference resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"referenceId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"UserReference resource deleted"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserReference"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/references":{"get":{"operationId":"UserReferenceController_getManyFromOrganisation","summary":"Retrieves the collection of UserReference resources.","parameters":[{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"name","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"orderBy[name]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserReference collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/UserReferenceEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserReference"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"UserReferenceController_postFromOrganisation","summary":"Creates a UserReference resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostUserReferenceDto"}}}},"responses":{"201":{"description":"UserReference resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserReferenceEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserReference"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/references/{referenceId}":{"get":{"operationId":"UserReferenceController_getFromOrganisation","summary":"Retrieves a UserReference resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"referenceId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserReference resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserReferenceEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserReference"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"UserReferenceController_putFromOrganisation","summary":"Replaces a UserReference resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"referenceId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutUserReferenceDto"}}}},"responses":{"200":{"description":"UserReference resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserReferenceEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserReference"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"UserReferenceController_deleteFromOrganisation","summary":"Removes a UserReference resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"referenceId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"UserReference resource deleted"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserReference"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/skills":{"get":{"operationId":"UserSkillController_getManyByUser","summary":"Retrieves the collection of UserSkill resources.","parameters":[{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"name","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"level","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"orderBy[name]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"orderBy[level]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserSkill collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/UserSkillEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserSkill"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"UserSkillController_post","summary":"Creates a UserSkill resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostUserSkillDto"}}}},"responses":{"201":{"description":"UserSkill resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserSkillEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserSkill"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/skills/{skillId}":{"get":{"operationId":"UserSkillController_getByUser","summary":"Retrieves a UserSkill resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"skillId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserSkill resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserSkillEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserSkill"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"UserSkillController_put","summary":"Replaces a UserSkill resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"skillId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutUserSkillDto"}}}},"responses":{"200":{"description":"UserSkill resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserSkillEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserSkill"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"UserSkillController_delete","summary":"Removes a UserSkill resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"skillId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"UserSkill resource deleted"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserSkill"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/skills":{"get":{"operationId":"UserSkillController_getManyFromOrganisation","summary":"Retrieves the collection of UserSkill resources.","parameters":[{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"name","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"level","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"orderBy[name]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"orderBy[level]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserSkill collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/UserSkillEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserSkill"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"UserSkillController_postFromOrganisation","summary":"Creates a UserSkill resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostUserSkillDto"}}}},"responses":{"201":{"description":"UserSkill resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserSkillEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserSkill"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/skills/{skillId}":{"get":{"operationId":"UserSkillController_getFromOrganisation","summary":"Retrieves a UserSkill resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"skillId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserSkill resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserSkillEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserSkill"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"UserSkillController_putFromOrganisation","summary":"Replaces a UserSkill resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"skillId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutUserSkillDto"}}}},"responses":{"200":{"description":"UserSkill resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserSkillEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserSkill"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"UserSkillController_deleteFromOrganisation","summary":"Removes a UserSkill resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"skillId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"UserSkill resource deleted"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserSkill"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/userTitles":{"get":{"operationId":"UserTitleController_getManyByUser","summary":"Retrieves a UserTitle collection.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"orderBy[level]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}}],"responses":{"200":{"description":"UserTitle resource","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/UserTitleEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserTitle"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"UserTitleController_post","summary":"Creates a UserTitle resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostUserTitleDto"}}}},"responses":{"201":{"description":"UserTitle resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserTitleEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserTitle"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/userTitles/{userTitleId}":{"get":{"operationId":"UserTitleController_getByUser","summary":"Retrieves a UserTitle resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userTitleId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserTitle resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserTitleEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserTitle"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"UserTitleController_put","summary":"Replaces a UserTitle resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userTitleId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutUserTitleDto"}}}},"responses":{"200":{"description":"UserTitle resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserTitleEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserTitle"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"UserTitleController_delete","summary":"Removes a UserTitle resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userTitleId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"UserTitle resource deleted"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserTitle"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/userTitles/{userTitleId}":{"get":{"operationId":"UserTitleController_getFromOrganisation","summary":"Retrieves a UserTitle resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userTitleId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserTitle resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserTitleEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserTitle"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"UserTitleController_putFromOrganisation","summary":"Replaces a UserTitle resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userTitleId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutUserTitleDto"}}}},"responses":{"200":{"description":"UserTitle resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserTitleEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserTitle"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"UserTitleController_deleteFromOrganisation","summary":"Removes a UserTitle resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userTitleId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"UserTitle resource deleted"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserTitle"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/userTitles":{"get":{"operationId":"UserTitleController_getManyFromOrganisation","summary":"Retrieves the collection of UserTitle resources.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"orderBy[level]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}}],"responses":{"200":{"description":"UserTitle collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/UserTitleEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserTitle"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"UserTitleController_postFromOrganisation","summary":"Creates a UserTitle resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostUserTitleDto"}}}},"responses":{"201":{"description":"UserTitle resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserTitleEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserTitle"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/volunteers":{"get":{"operationId":"UserVolunteerController_getManyByUser","summary":"Retrieves the collection of UserVolunteer resources.","parameters":[{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"position","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"orderBy[position]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserVolunteer collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/UserVolunteerEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserVolunteer"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"UserVolunteerController_post","summary":"Creates a UserVolunteer resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostUserVolunteerDto"}}}},"responses":{"201":{"description":"UserVolunteer resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserVolunteerEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserVolunteer"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/volunteers/{volunteerId}":{"get":{"operationId":"UserVolunteerController_getByUser","summary":"Retrieves a UserVolunteer resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"volunteerId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserVolunteer resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserVolunteerEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserVolunteer"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"UserVolunteerController_put","summary":"Replaces a UserVolunteer resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"volunteerId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutUserVolunteerDto"}}}},"responses":{"200":{"description":"UserVolunteer resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserVolunteerEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserVolunteer"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"UserVolunteerController_delete","summary":"Removes a UserVolunteer resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"volunteerId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"UserVolunteer resource deleted"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserVolunteer"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/volunteers":{"get":{"operationId":"UserVolunteerController_getManyFromOrganisation","summary":"Retrieves the collection of UserVolunteer resources.","parameters":[{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"position","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"orderBy[position]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserVolunteer collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/UserVolunteerEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserVolunteer"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"UserVolunteerController_postFromOrganisation","summary":"Creates a UserVolunteer resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostUserVolunteerDto"}}}},"responses":{"201":{"description":"UserVolunteer resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserVolunteerEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserVolunteer"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/volunteers/{volunteerId}":{"get":{"operationId":"UserVolunteerController_getFromOrganisation","summary":"Retrieves a UserVolunteer resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"volunteerId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserVolunteer resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserVolunteerEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserVolunteer"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"UserVolunteerController_putFromOrganisation","summary":"Replaces a UserVolunteer resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"volunteerId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutUserVolunteerDto"}}}},"responses":{"200":{"description":"UserVolunteer resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserVolunteerEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserVolunteer"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"UserVolunteerController_deleteFromOrganisation","summary":"Removes a UserVolunteer resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"volunteerId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"UserVolunteer resource deleted"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserVolunteer"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/works":{"get":{"operationId":"UserWorkController_getManyByUser","summary":"Retrieves the collection of UserWork resources.","parameters":[{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"position","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"orderBy[position]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserWork collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/UserWorkEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserWork"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"UserWorkController_post","summary":"Creates a UserWork resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostUserWorkDto"}}}},"responses":{"201":{"description":"UserWork resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserWorkEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserWork"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/users/{userId}/works/{workId}":{"get":{"operationId":"UserWorkController_getByUser","summary":"Retrieves a UserWork resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"workId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserWork resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserWorkEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserWork"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"UserWorkController_put","summary":"Replaces a UserWork resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"workId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutUserWorkDto"}}}},"responses":{"200":{"description":"UserWork resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserWorkEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserWork"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"UserWorkController_delete","summary":"Removes a UserWork resource.","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"workId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"UserWork resource deleted"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserWork"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/works":{"get":{"operationId":"UserWorkController_getManyFromOrganisation","summary":"Retrieves the collection of UserWork resources.","parameters":[{"name":"page","required":false,"in":"query","description":"The collection page number","schema":{"minimum":1,"default":1,"example":1,"type":"number"}},{"name":"itemsPerPage","required":false,"in":"query","description":"The number of items per page","schema":{"minimum":1,"maximum":1000,"default":30,"example":30,"type":"number"}},{"name":"position","required":false,"in":"query","schema":{"nullable":true,"type":"string"}},{"name":"orderBy[position]","required":false,"in":"query","schema":{"example":"asc","enum":["asc","desc"],"type":"string"}},{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserWork collection","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraPaginator"},{"properties":{"hydra:member":{"type":"array","items":{"$ref":"#/components/schemas/UserWorkEntity"}}}}]}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserWork"],"security":[{"bearer":[]},{"api_key":[]}]},"post":{"operationId":"UserWorkController_postFromOrganisation","summary":"Creates a UserWork resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostUserWorkDto"}}}},"responses":{"201":{"description":"UserWork resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserWorkEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserWork"],"security":[{"bearer":[]},{"api_key":[]}]}},"/v1/organisations/{organisationId}/users/{userId}/works/{workId}":{"get":{"operationId":"UserWorkController_getFromOrganisation","summary":"Retrieves a UserWork resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"workId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"UserWork resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserWorkEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserWork"],"security":[{"bearer":[]},{"api_key":[]}]},"put":{"operationId":"UserWorkController_putFromOrganisation","summary":"Replaces a UserWork resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"workId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutUserWorkDto"}}}},"responses":{"200":{"description":"UserWork resource replaced","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UserWorkEntity"}}}},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserWork"],"security":[{"bearer":[]},{"api_key":[]}]},"delete":{"operationId":"UserWorkController_deleteFromOrganisation","summary":"Removes a UserWork resource.","parameters":[{"name":"organisationId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"workId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"UserWork resource deleted"},"400":{"description":"Bad request","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"401":{"description":"Unauthorized","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/HydraError"}]}}}}},"tags":["UserWork"],"security":[{"bearer":[]},{"api_key":[]}]}}},"info":{"title":"API Skillberg","description":"\n[Skillberg](https://skillberg.app) is a deeptech HR platform that helps organisations manage talent through AI-powered document processing, skill extraction, and career management. This is the reference documentation for **Skillberg's API**.\n\n---\n\n## Who is this API for?\n\n| Audience | Use case |\n|---|---|\n| **Partner integrations** | Third-party systems that connect via API key to push/pull HR data |\n| **Internal services** | AI pipeline that processes CVs and enriches candidate profiles |\n\n---\n\n## Authentication\n\nAll endpoints require one of the following:\n\n- **Bearer Token** — JWT issued by Auth0. Used by logged-in users via the frontend. Pass it as `Authorization: Bearer <token>`.\n- **API Key** — Static key for service-to-service calls. Pass it as the `x-api-key` header.\n\nSome endpoints accept either method. Check the lock icon on each endpoint to see which schemes apply.\n\n---\n\n## Response format\n\nAll responses follow the **JSON-LD / Hydra** standard:\n\n**Single resource:**\n```json\n{\n  \"@context\": \"/contexts/User\",\n  \"@type\": \"User\",\n  \"@id\": \"/users/60f7...\",\n  \"id\": \"60f7...\",\n  \"email\": \"jane@example.com\"\n}\n```\n\n**Collection (paginated):**\n```json\n{\n  \"@context\": \"/contexts/User\",\n  \"@type\": \"hydra:Collection\",\n  \"hydra:totalItems\": 42,\n  \"hydra:member\": [ ... ],\n  \"hydra:view\": {\n    \"hydra:first\": \"/users?page=1\",\n    \"hydra:last\": \"/users?page=5\",\n    \"hydra:next\": \"/users?page=3\"\n  }\n}\n```\n\nPagination is controlled via the `page` and `itemsPerPage` query parameters.\n\n**Errors** (`/v1` routes) follow a single, flat envelope:\n```json\n{\n  \"error\": {\n    \"code\": \"not_found\",\n    \"message\": \"Resource not found\",\n    \"request_id\": \"3f1c9b8e-2a4d-4e7f-9c0a-1b2c3d4e5f60\"\n  }\n}\n```\n\nEvery response — success or error — carries an `X-Request-Id` header; quote its\nvalue (mirrored in `request_id` on errors) when contacting support. Routes\nserved outside the `/v1` prefix (auth flow, health probe) still return the\nlegacy `hydra:Error` shape.\n\n---\n\n## Main resource groups\n\n### Organisation & users\nManage organisations, their users, roles, and teams.\n- **Organisation** — CRUD for organisations\n- **User** — User profiles and account management\n- **Auth0** — Authentication and token handling\n- **Roles** — Permission management (bit-flag based)\n- **Team** — Team structure within organisations\n\n### Document processing pipeline\nThe core AI pipeline that extracts structured data from CVs and resumes:\n\n```\nPDF Upload → Document (raw) → Treat (via AI) → TreatedDocument\n    → CorrectedTreatedDocument (manual corrections)\n        → Enrich (via AI) → EnrichedDocument\n            → CorrectedEnrichedDocument (assign sector/job UUIDs)\n                → User entities (UserWork, UserEducation, UserSkill...)\n```\n\n- **Document** — Upload, treat, enrich, correct documents through the full pipeline\n\n### User profile entities\nStructured data extracted from documents or entered manually:\n- **UserWork** — Work experience\n- **UserEducation** — Education history\n- **UserSkill** — Skills\n- **UserVolunteer** — Volunteer experience\n- **UserInterest** — Interests\n- **UserProject** — Projects\n- **UserAward** — Awards\n- **UserCertificate** — Certificates\n- **UserPublication** — Publications\n- **UserLanguage** — Languages\n- **UserReference** — References\n- **UserTitle** — Job titles (extracted best matches)\n\n### Talent management\n- **Offer** — Job offers published by organisations\n- **OfferUser** — Candidate–offer matching and applications\n- **Career** — Career paths and frameworks\n- **CareerUser** — User progression within career paths\n- **Evaluation** — Skill and performance evaluations\n- **SkillSet** — Curated sets of skills for matching\n\n### Platform structure\n- **Program** — Training programs\n- **Project** — Organisational projects\n- **Course** — Learning courses\n- **Mission** — Missions and assignments\n- **Session** — Training or evaluation sessions\n\n### AI & utilities\n- **SkillbergAI** — AI-powered features (matching, recommendations)\n- **Api** — Health checks and API metadata\n\n---\n\n## Route conventions\n\nMost resources are nested under organisations and users:\n\n```\n/organisations/:orgId/users/:userId/works      → Org manages a user's work entries\n/users/:userId/works                            → User manages their own work entries\n```\n\nBoth route families provide the same functionality but differ in authorization:\n- **Organisation routes** use `PermissionsGuard` (role-based access)\n- **User routes** use `IsSelfGuard` (the authenticated user can only access their own data)\n","version":"1.1.0","contact":{"name":"Skillberg","url":"https://skillberg.app","email":"contact@skillberg.app"}},"tags":[{"name":"Api","description":"Service health checks and API metadata used for monitoring and load-balancer probes."},{"name":"Authentication","description":"User login, JWT refresh, and per-user API key management."},{"name":"Career","description":"Career paths and frameworks that define progression tracks within an organisation."},{"name":"CareerUser","description":"A user's progression and assignments within career paths."},{"name":"Certificates","description":"Certificates extracted from a user's CV or added manually to their profile."},{"name":"Course","description":"Learning courses grouped within programs."},{"name":"Document","description":"CV/PDF processing pipeline — upload, AI treatment, enrichment and manual corrections that produce a structured user profile."},{"name":"Evaluation","description":"Skill and performance evaluations carried out on a user."},{"name":"JobPosting","description":""},{"name":"Mission","description":"Missions and assignments given to teams or users."},{"name":"Offer","description":"Job offers published by organisations."},{"name":"OfferUser","description":"Candidate applications and matching between users and job offers."},{"name":"Organisation","description":"Organisations and their core settings."},{"name":"OrganisationPlans","description":"The subscription plan currently assigned to each organisation."},{"name":"PaymentOrganisation","description":"An organisation's billing identity and payment-provider (Mollie) linkage."},{"name":"Plans","description":"Catalogue of subscription plans (pricing, credits, limits), including the public marketing list."},{"name":"Program","description":"Training programs that group courses and sessions."},{"name":"Project","description":"Projects run within an organisation."},{"name":"Public API — Account","description":""},{"name":"Public API — Analyse","description":""},{"name":"Public API — Consultation","description":""},{"name":"Public API — Intelligence","description":""},{"name":"Roles","description":"Permission roles (bit-flag based) that govern access to organisation resources."},{"name":"Session","description":"Training or evaluation sessions."},{"name":"SkillSet","description":"Curated sets of skills used as references for matching."},{"name":"SkillbergAI","description":"AI features over the Skillberg knowledge graph — semantic skill search, matching, recommendations and profile completion."},{"name":"SonarUser","description":"A user's Sonar-specific profile tracking onboarding with the Sonar billing service."},{"name":"Team","description":"Teams that group users within an organisation."},{"name":"Usage","description":"Credit and API-usage metering for an organisation — summaries, daily breakdowns and top routes."},{"name":"User","description":"User profiles and account management."},{"name":"UserAward","description":"Awards on a user's profile."},{"name":"UserEducation","description":"Education history on a user's profile."},{"name":"UserInterest","description":"Interests on a user's profile."},{"name":"UserLanguage","description":"Languages spoken on a user's profile."},{"name":"UserProject","description":"Projects on a user's profile."},{"name":"UserPublication","description":"Publications on a user's profile."},{"name":"UserReference","description":"References on a user's profile."},{"name":"UserSkill","description":"Skills on a user's profile."},{"name":"UserTitle","description":"Best-matched job titles inferred for a user."},{"name":"UserVolunteer","description":"Volunteer experience on a user's profile."},{"name":"UserWork","description":"Work experience on a user's profile."}],"servers":[],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http"},"api_key":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"SkillHitDto":{"type":"object","properties":{"uri":{"type":"string","example":"skillberg://skill/a1b2c3..."},"uuid":{"type":"string"},"name":{"type":"string"},"labels":{"example":["Skill","Hardskill","Item"],"type":"array","items":{"type":"string"}},"score":{"type":"number","example":0.87,"description":"Cosine similarity score (0-1)"}},"required":["uri","uuid","name","labels","score"]},"SkillSearchResponse":{"type":"object","properties":{"results":{"type":"array","items":{"$ref":"#/components/schemas/SkillHitDto"}}},"required":["results"]},"SkillEntityDto":{"type":"object","properties":{"uri":{"type":"string"},"uuid":{"type":"string"},"name":{"type":"string"},"labels":{"type":"array","items":{"type":"string"}},"description":{"type":"object","nullable":true},"proficiency_description":{"type":"object","nullable":true},"proficiency_level_num":{"type":"object","nullable":true}},"required":["uri","uuid","name","labels"]},"SkillsExtractRequestDto":{"type":"object","properties":{"occupation":{"type":"string","description":"Occupation URI or title to extract the skill profile for","example":"skillberg://occupation/2511"}},"required":["occupation"]},"SkillsRecommendRequestDto":{"type":"object","properties":{"skills":{"description":"Seed skill URIs to expand from","type":"array","items":{"type":"string"}}},"required":["skills"]},"CvScoreRequestDto":{"type":"object","properties":{"resume":{"type":"object","description":"Enriched CV (json_resume) to score. (Contract pending — see route TODO.)"},"section_weights":{"type":"object","description":"Optional per-section weights (basics/work/education/skills…), normalized by Gyre."}},"required":["resume"]},"MatchOccupationRequestDto":{"type":"object","properties":{"title":{"type":"string","description":"Job title to match cross-framework","example":"Lead Data Scientist"}},"required":["title"]},"EnrichJobOfferRequestDto":{"type":"object","properties":{"jsonJob":{"type":"object","description":"Job offer (Skillberg_jobPosting object) to enrich with implicit skills. Proxied to Gyre /bummock/jsonJob/enrich."}},"required":["jsonJob"]},"EnrichCvRequestDto":{"type":"object","properties":{"resume":{"type":"object","description":"Treated CV (json_resume object) to enrich with implicit skills. Proxied to Gyre /bummock/jsonResume/enrich."}},"required":["resume"]},"MatchCvsVsJobRequestDto":{"type":"object","properties":{"profiles":{"type":"object","description":"Pre-indexed candidate profiles. (Contract pending — see route TODO.)"},"target_jobs":{"type":"object","description":"Target job(s) with weights."}},"required":["profiles","target_jobs"]},"MatchJobsVsCvRequestDto":{"type":"object","properties":{"profile":{"type":"object","description":"Single candidate profile. (Contract pending — see route TODO.)"},"target_jobs":{"type":"object","description":"Pool of target jobs with weights."}},"required":["profile","target_jobs"]},"SkillsGapRequestDto":{"type":"object","properties":{"profile":{"type":"object","description":"Candidate profile."},"target_occupation":{"type":"string","description":"Target occupation URI","example":"skillberg://occupation/2511"}},"required":["profile","target_occupation"]},"WorkforceMapRequestDto":{"type":"object","properties":{"architecture":{"type":"object","description":"Bulk occupation architecture to map."},"target_framework":{"type":"string","description":"Target framework","example":"ESCO"}},"required":["architecture","target_framework"]},"CareerTransitionsRequestDto":{"type":"object","properties":{"from_occupation":{"type":"string","description":"Origin occupation URI","example":"skillberg://occupation/2511"}},"required":["from_occupation"]},"AccountCreditsResponse":{"type":"object","properties":{"credits_remaining":{"type":"number","description":"Credits left in the current period."},"monthly_credits":{"type":"number","description":"Credits granted per period."},"credits_used_this_period":{"type":"number","description":"Credits consumed so far this period."},"period_start":{"format":"date-time","type":"string","description":"Start of the current billing period."},"period_end":{"format":"date-time","type":"string","description":"End of the current billing period."},"overage_price_eur":{"type":"number","description":"Per-credit price charged once in overage (€)."},"unlimited":{"type":"boolean","description":"Present (true) only for the master key, which is not metered. Absent for a normal key."}},"required":["credits_remaining","monthly_credits","credits_used_this_period","period_start","period_end","overage_price_eur"]},"CareerEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"name":{"type":"string"},"description":{"type":"object","example":null},"sector_uuid":{"type":"string"},"job_uuid":{"type":"string"},"organisation":{"type":"string","example":"/organisations/507f1f77bcf86cd799439011"}},"required":["id","created_at","updated_at","name","description","sector_uuid","job_uuid","organisation"]},"PostCareerDto":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"object","example":null},"sector_uuid":{"type":"string"},"job_uuid":{"type":"string"}},"required":["name","description","sector_uuid","job_uuid"]},"PutCareerDto":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"object","example":null},"sector_uuid":{"type":"string"},"job_uuid":{"type":"string"}},"required":["name","description","sector_uuid","job_uuid"]},"CareerUserEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"start_date":{"format":"date-time","type":"string"},"end_date":{"format":"date-time","type":"string"}},"required":["id","created_at","updated_at","start_date","end_date"]},"PostCareerUserDto":{"type":"object","properties":{"user_id":{"type":"string"},"start_date":{"format":"date-time","type":"string"},"end_date":{"format":"date-time","type":"string"}},"required":["user_id","start_date","end_date"]},"PutCareerUserDto":{"type":"object","properties":{"user_id":{"type":"string"},"start_date":{"format":"date-time","type":"string"},"end_date":{"format":"date-time","type":"string"}},"required":["user_id","start_date","end_date"]},"SocialLinksSchema":{"type":"object","properties":{"github":{"type":"object","nullable":true},"gitlab":{"type":"object","nullable":true},"linkedin":{"type":"object","nullable":true}},"required":["github","gitlab","linkedin"]},"MotivationsSchema":{"type":"object","properties":{"dev":{"default":[],"type":"array","items":{"type":"string"}},"rh":{"default":[],"type":"array","items":{"type":"string"}},"of":{"default":[],"type":"array","items":{"type":"string"}}},"required":["dev","rh","of"]},"HydraRelation":{"type":"object","properties":{"@context":{"type":"string"},"@id":{"type":"string"},"@type":{"type":"string"},"hydra:title":{"type":"string"},"hydra:description":{"type":"string"},"hydra:totalItems":{"type":"number"}},"required":["@context","@id","@type","hydra:title","hydra:description","hydra:totalItems"]},"UserEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"email":{"type":"string","nullable":true},"name":{"type":"string","nullable":true},"surname":{"type":"string","nullable":true},"username":{"type":"string","nullable":true},"date_of_birth":{"format":"date-time","type":"string","nullable":true},"social_links":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/SocialLinksSchema"}]},"motivations":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/MotivationsSchema"}]},"skillSet":{"type":"object","example":"/skillSets/507f1f77bcf86cd799439011","nullable":true},"evaluations":{"$ref":"#/components/schemas/HydraRelation"},"titles":{"$ref":"#/components/schemas/HydraRelation"}},"required":["id","created_at","updated_at","email","name","surname","username","date_of_birth","social_links","motivations","skillSet","evaluations","titles"]},"PostUserDto":{"type":"object","properties":{"email":{"type":"string","nullable":true},"name":{"type":"string","nullable":true},"surname":{"type":"string","nullable":true},"username":{"type":"string","nullable":true},"date_of_birth":{"format":"date-time","type":"string","nullable":true},"social_links":{"type":"object"},"motivations":{"type":"object"},"skillSet_id":{"type":"string"}},"required":["email","name","surname","username","date_of_birth","social_links","motivations","skillSet_id"]},"PutUserDto":{"type":"object","properties":{"email":{"type":"string","nullable":true},"name":{"type":"string","nullable":true},"surname":{"type":"string","nullable":true},"username":{"type":"string","nullable":true},"date_of_birth":{"format":"date-time","type":"string","nullable":true},"social_links":{"type":"object"},"motivations":{"type":"object"},"skillSet_id":{"type":"string"}},"required":["email","name","surname","username","date_of_birth","social_links","motivations","skillSet_id"]},"UsersToCompareDto":{"type":"object","properties":{"user_id_list":{"type":"array","items":{"type":"string"}}},"required":["user_id_list"]},"GyreRecommendedItem":{"type":"object","properties":{"UUID":{"type":"string"},"name":{"type":"string"},"labels":{"type":"string"},"finalScore":{"type":"number"},"scoreSkillberg":{"type":"object"}},"required":["UUID","name","labels","finalScore","scoreSkillberg"]},"GyreAlternativeItem":{"type":"object","properties":{"UUID":{"type":"string"},"name":{"type":"string"},"cosineScores":{"type":"array","items":{"type":"string"}},"labels":{"type":"array","items":{"type":"string"}},"finalScore":{"type":"number"}},"required":["UUID","name","cosineScores","labels","finalScore"]},"GyrePositionMatch":{"type":"object","properties":{"original":{"type":"string"},"recommended":{"type":"array","items":{"$ref":"#/components/schemas/GyreRecommendedItem"}},"alternatives":{"type":"array","items":{"$ref":"#/components/schemas/GyreAlternativeItem"}}},"required":["original","recommended","alternatives"]},"GyreSummaryMatch":{"type":"object","properties":{"original":{"type":"string"},"recommended":{"type":"array","items":{"$ref":"#/components/schemas/GyreRecommendedItem"}},"alternatives":{"type":"array","items":{"$ref":"#/components/schemas/GyreAlternativeItem"}}},"required":["original","recommended","alternatives"]},"GyreHighlightMatch":{"type":"object","properties":{"original":{"type":"string"},"recommended":{"type":"array","items":{"$ref":"#/components/schemas/GyreRecommendedItem"}},"alternatives":{"type":"array","items":{"$ref":"#/components/schemas/GyreAlternativeItem"}}},"required":["original","recommended","alternatives"]},"GyreWorkMatch":{"type":"object","properties":{"position":{"$ref":"#/components/schemas/GyrePositionMatch"},"summary":{"$ref":"#/components/schemas/GyreSummaryMatch"},"highlights":{"type":"array","items":{"$ref":"#/components/schemas/GyreHighlightMatch"}}},"required":["position","summary","highlights"]},"GyreSkillOriginal":{"type":"object","properties":{"name":{"type":"string"},"level":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}}},"required":["name","level","keywords"]},"GyreSkillMatch":{"type":"object","properties":{"original":{"$ref":"#/components/schemas/GyreSkillOriginal"},"recommended":{"type":"array","items":{"$ref":"#/components/schemas/GyreRecommendedItem"}},"alternatives":{"type":"array","items":{"$ref":"#/components/schemas/GyreAlternativeItem"}}},"required":["original","recommended","alternatives"]},"GyreMatchingResponse":{"type":"object","properties":{"work":{"type":"array","items":{"$ref":"#/components/schemas/GyreWorkMatch"}},"skills":{"type":"array","items":{"$ref":"#/components/schemas/GyreSkillMatch"}}},"required":["work","skills"]},"MatchingScoreResponse":{"type":"object","properties":{"@context":{"type":"string"},"@id":{"type":"string"},"@type":{"type":"string"},"job_id":{"type":"string"},"resume":{"type":"object"},"query":{"type":"string"},"skillbergSkills":{"type":"array","items":{"type":"string"}},"gyre_response":{"$ref":"#/components/schemas/GyreMatchingResponse"}},"required":["@context","@id","@type","job_id","resume","query","skillbergSkills"]},"CompletionWeightsDto":{"type":"object","properties":{"basics":{"type":"number"},"work":{"type":"number"},"education":{"type":"number"},"skills":{"type":"number"},"projects":{"type":"number"},"volunteer":{"type":"number"},"awards":{"type":"number"},"publications":{"type":"number"}}},"CompletionScoreResponse":{"type":"object","properties":{"completion_score":{"type":"number"},"section_score":{"type":"object"},"missing_sections":{"type":"array","items":{"type":"string"}},"comments":{"type":"object"},"ranking":{"type":"object"},"scoring_weights":{"type":"object"}},"required":["completion_score","section_score","missing_sections","comments","ranking","scoring_weights"]},"BaseVertexType":{"type":"object","properties":{}},"BaseEdgeType":{"type":"object","properties":{}},"SkillSetEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"key_skills_list":{"type":"array","items":{"$ref":"#/components/schemas/BaseVertexType"}},"skills_list":{"type":"array","items":{"$ref":"#/components/schemas/BaseVertexType"}},"edges_list":{"type":"array","items":{"$ref":"#/components/schemas/BaseEdgeType"}}},"required":["id","created_at","updated_at","key_skills_list","skills_list","edges_list"]},"BaseVertexDto":{"type":"object","properties":{"aws_id":{"type":"string"},"label":{"type":"string"},"name":{"type":"string"}},"required":["aws_id","label","name"]},"BaseEdgeDto":{"type":"object","properties":{"source":{"type":"string"},"target":{"type":"string"},"label":{"type":"string"}},"required":["source","target","label"]},"PostSkillSetDto":{"type":"object","properties":{"key_skills_list":{"type":"array","items":{"$ref":"#/components/schemas/BaseVertexDto"}},"skills_list":{"type":"array","items":{"$ref":"#/components/schemas/BaseVertexDto"}},"edges_list":{"type":"array","items":{"$ref":"#/components/schemas/BaseEdgeDto"}}},"required":["key_skills_list","skills_list","edges_list"]},"PutSkillSetDto":{"type":"object","properties":{"key_skills_list":{"type":"array","items":{"$ref":"#/components/schemas/BaseVertexDto"}},"skills_list":{"type":"array","items":{"$ref":"#/components/schemas/BaseVertexDto"}},"edges_list":{"type":"array","items":{"$ref":"#/components/schemas/BaseEdgeDto"}}},"required":["key_skills_list","skills_list","edges_list"]},"SessionEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"organisation":{"type":"string","example":"/organisations/507f1f77bcf86cd799439011"},"program":{"type":"object","example":"/programs/507f1f77bcf86cd799439011","nullable":true},"name":{"type":"string"},"start_date":{"format":"date-time","type":"string"},"end_date":{"format":"date-time","type":"string"},"learners":{"$ref":"#/components/schemas/HydraRelation"},"programs":{"$ref":"#/components/schemas/HydraRelation"}},"required":["id","created_at","updated_at","organisation","program","name","start_date","end_date","learners","programs"]},"PostSessionDto":{"type":"object","properties":{"name":{"type":"string"},"start_date":{"format":"date-time","type":"string"},"end_date":{"format":"date-time","type":"string"}},"required":["name","start_date","end_date"]},"PutSessionDto":{"type":"object","properties":{"name":{"type":"string"},"start_date":{"format":"date-time","type":"string"},"end_date":{"format":"date-time","type":"string"}},"required":["name","start_date","end_date"]},"LoginDto":{"type":"object","properties":{"user_id":{"type":"string"}},"required":["user_id"]},"AuthenticationResponse":{"type":"object","properties":{"access_token":{"type":"string"},"refresh_token":{"type":"string"}},"required":["access_token","refresh_token"]},"RefreshTokenDto":{"type":"object","properties":{"user_id":{"type":"string"}},"required":["user_id"]},"ApiKeyEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"user_id":{"type":"string","example":"507f1f77bcf86cd799439011"},"organisation_id":{"type":"string","example":"507f1f77bcf86cd799439011"},"name":{"type":"string"},"key":{"type":"string","nullable":true,"description":"Plaintext API key. Returned ONCE on the create response; absent on every subsequent read."},"key_hash":{"type":"string","description":"SHA-256 hash of the raw key. Internal."},"key_prefix":{"type":"string"},"key_last4":{"type":"string"},"expiration_date":{"type":"object","nullable":true},"permissions":{"type":"number"},"active":{"type":"boolean"},"origin":{"type":"string","description":"Provenance of the key: 'api' (public API) or 'mcp' (Claude MCP connector).","enum":["api","mcp"],"default":"api"},"credits_remaining":{"type":"number","description":"Credits left in the current period."},"monthly_credits":{"type":"number","description":"Credits granted per period. Seed 10000 = Builder-equivalent."},"overage_price_eur":{"type":"number","description":"Per-credit price charged once in overage (€)."},"period_start":{"format":"date-time","type":"string","description":"Start of the current billing period."},"period_end":{"format":"date-time","type":"string","description":"End of the current billing period."},"credits_used_this_period":{"type":"number","description":"Credits consumed so far this period."}},"required":["id","created_at","updated_at","user_id","organisation_id","name","key","key_hash","key_prefix","key_last4","expiration_date","permissions","active","origin","credits_remaining","monthly_credits","overage_price_eur","period_start","period_end","credits_used_this_period"]},"PostApiKeyDto":{"type":"object","properties":{"name":{"type":"string"},"expiration_date":{"type":"object","nullable":true},"permissions":{"type":"number"},"organisation_id":{"type":"string"}},"required":["name","expiration_date","permissions","organisation_id"]},"TeamEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"organisation":{"type":"string","example":"/organisations/507f1f77bcf86cd799439011"},"name":{"type":"string"},"description":{"type":"string"}},"required":["id","created_at","updated_at","organisation","name","description"]},"PostTeamDto":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"}},"required":["name","description"]},"PutTeamDto":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"}},"required":["name","description"]},"PatchTeamDto":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"}}},"OfferEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"organisation":{"type":"string","example":"/organisations/507f1f77bcf86cd799439011"},"name":{"type":"string"},"skillSet":{"type":"object","example":"/skillSets/507f1f77bcf86cd799439011","nullable":true},"candidates":{"$ref":"#/components/schemas/HydraRelation"}},"required":["id","created_at","updated_at","organisation","name","skillSet","candidates"]},"CompatibilityResponse":{"type":"object","properties":{"id":{"type":"string","example":"507f1f77bcf86cd799439011"},"compatibilities":{"type":"array","items":{"type":"string"}}},"required":["id","compatibilities"]},"PostOfferDto":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]},"PutOfferDto":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]},"ObjectId":{"type":"object","properties":{}},"OfferUserEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"offer":{"type":"string","example":"/offers/507f1f77bcf86cd799439011"},"user_id":{"example":"/users/507f1f77bcf86cd799439011","allOf":[{"$ref":"#/components/schemas/ObjectId"}]}},"required":["id","created_at","updated_at","offer","user_id"]},"PostOfferUserDto":{"type":"object","properties":{"user_id":{"type":"string"}},"required":["user_id"]},"PutOfferUserDto":{"type":"object","properties":{"user_id":{"type":"string"}},"required":["user_id"]},"OrganisationEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"name":{"type":"string"},"location":{"type":"string"},"link":{"type":"string"},"activity_list":{"type":"array","items":{"type":"string"}},"cap_at_quota":{"type":"boolean","description":"When true, API calls beyond the current period quota are rejected by the API gateway. Default false (overage allowed, billed per credit)."},"offers":{"$ref":"#/components/schemas/HydraRelation"},"courses":{"$ref":"#/components/schemas/HydraRelation"},"sessions":{"$ref":"#/components/schemas/HydraRelation"},"programs":{"$ref":"#/components/schemas/HydraRelation"},"teams":{"$ref":"#/components/schemas/HydraRelation"}},"required":["id","created_at","updated_at","name","location","link","activity_list","cap_at_quota","offers","courses","sessions","programs","teams"]},"PostOrganisationDto":{"type":"object","properties":{"name":{"type":"string"},"location":{"type":"string"},"link":{"type":"string"},"activity_list":{"type":"array","items":{"type":"string"}},"cap_at_quota":{"type":"boolean","description":"When true, API calls beyond the current period quota are rejected by the API gateway. Default false (overage allowed, billed per credit)."}},"required":["name","location","link","activity_list","cap_at_quota"]},"PutOrganisationDto":{"type":"object","properties":{"name":{"type":"string"},"location":{"type":"string"},"link":{"type":"string"},"activity_list":{"type":"array","items":{"type":"string"}},"cap_at_quota":{"type":"boolean","description":"When true, API calls beyond the current period quota are rejected by the API gateway. Default false (overage allowed, billed per credit)."}},"required":["name","location","link","activity_list","cap_at_quota"]},"PatchOrganisationDto":{"type":"object","properties":{"name":{"type":"string"},"location":{"type":"string"},"link":{"type":"string"},"activity_list":{"type":"array","items":{"type":"string"}},"cap_at_quota":{"type":"boolean","description":"When true, API calls beyond the current period quota are rejected by the API gateway. Default false (overage allowed, billed per credit)."}}},"OrganisationPlanEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"organisation":{"type":"string","example":"/organisations/507f1f77bcf86cd799439011"},"plan_id":{"example":"507f1f77bcf86cd799439011","description":"Mongo _id of the Plan. Resolve via the cached /plans collection on the client (Plan.code is the human-readable key).","allOf":[{"$ref":"#/components/schemas/ObjectId"}]},"previous_organisation_plan":{"type":"object","example":"/organisationPlans/507f1f77bcf86cd799439011","nullable":true},"pending_plan_id":{"type":"object","example":"507f1f77bcf86cd799439011","nullable":true,"description":"Set by schedule-mollie-switch when a customer queues a plan change. At current_period_end, the next Mollie subscription payment triggers mollie-confirm which supersedes this maillon and creates a new active one. UI uses this to render \"switching to X on YYYY-MM-DD\" on the current maillon."},"billing_cycle":{"type":"string","enum":["monthly","annual"]},"status":{"type":"string","enum":["payment_pending","active","past_due","unpaid","canceled","incomplete_expired","superseded"]},"current_period_start":{"format":"date-time","type":"string"},"current_period_end":{"format":"date-time","type":"string"},"started_at":{"format":"date-time","type":"string"},"canceled_at":{"format":"date-time","type":"string","nullable":true},"ended_at":{"format":"date-time","type":"string","nullable":true,"description":"Date à laquelle le maillon a été terminé (superseded ou fin de période après cancel). null = maillon courant."},"cancel_at_period_end":{"type":"boolean"},"payment_provider":{"type":"string","nullable":true,"enum":["paddle","stripe","mollie","manual"],"description":"Payment provider that fulfilled this maillon. Null pour Discovery ou tout maillon gratuit hors PSP."},"payment_subscription_id":{"type":"string","nullable":true,"description":"Provider-side subscription ID (Paddle/Stripe/Mollie/...). Null pour Discovery ou paiement manuel."},"payment_customer_id":{"type":"string","nullable":true,"description":"Provider-side customer ID dénormalisé pour le routing webhook."}},"required":["id","created_at","updated_at","organisation","plan_id","previous_organisation_plan","pending_plan_id","billing_cycle","status","current_period_start","current_period_end","started_at","canceled_at","ended_at","cancel_at_period_end","payment_provider","payment_subscription_id","payment_customer_id"]},"DevCheckoutDto":{"type":"object","properties":{"plan_code":{"type":"string","enum":["discovery","builder","scale","partner","omni"]},"billing_cycle":{"type":"string","enum":["monthly","annual"],"default":"monthly"}},"required":["plan_code"]},"DowngradeToFreeDto":{"type":"object","properties":{"plan_code":{"type":"string","enum":["discovery","builder","scale","partner","omni"],"description":"Target free plan (price_monthly_eur null or 0). Service rejects with 400 if the plan is paid — keeps the safety promise that no paid plan is ever assigned without going through Mollie."},"billing_cycle":{"type":"string","enum":["monthly","annual"]}},"required":["plan_code"]},"RouteAccessEntity":{"type":"object","properties":{"consultation":{"type":"string","enum":["none","limited","full","priority"]},"analyse":{"type":"string","enum":["none","limited","full","priority"]},"intelligence":{"type":"string","enum":["none","limited","full","priority"]},"beta":{"type":"string","enum":["none","limited","full","priority"]}},"required":["consultation","analyse","intelligence","beta"]},"PspPriceIdsEntity":{"type":"object","properties":{"paddle_monthly":{"type":"string","nullable":true,"description":"Paddle Price ID for the monthly billing cycle."},"stripe_monthly":{"type":"string","nullable":true,"description":"Stripe price_id for the monthly billing cycle."},"mollie_monthly":{"type":"string","nullable":true,"description":"Mollie subscription template / price ID for the monthly billing cycle."}},"required":["paddle_monthly","stripe_monthly","mollie_monthly"]},"PlanEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"code":{"type":"string","enum":["discovery","builder","scale","partner","omni"]},"name":{"type":"string"},"price_monthly_eur":{"type":"number","nullable":true},"credits_per_month":{"type":"number","nullable":true},"overage_price_eur":{"type":"number","nullable":true},"daily_rate_limit":{"type":"number","nullable":true},"top_results_limit":{"type":"number"},"engagement_min_months":{"type":"number"},"route_access":{"$ref":"#/components/schemas/RouteAccessEntity"},"features":{"type":"array","items":{"type":"string"}},"sla_uptime_pct":{"type":"number","nullable":true},"support_tier":{"type":"string","enum":["self_service","email_48h","email_24h","csm_4h"]},"is_public":{"type":"boolean"},"psp_price_ids":{"$ref":"#/components/schemas/PspPriceIdsEntity"},"sort_order":{"type":"number"}},"required":["id","created_at","updated_at","code","name","price_monthly_eur","credits_per_month","overage_price_eur","daily_rate_limit","top_results_limit","engagement_min_months","route_access","features","sla_uptime_pct","support_tier","is_public","psp_price_ids","sort_order"]},"PublicPlanDto":{"type":"object","properties":{"code":{"type":"string","enum":["discovery","builder","scale","partner","omni"]},"name":{"type":"string"},"price_monthly_eur":{"type":"number","nullable":true},"credits_per_month":{"type":"number","nullable":true},"overage_price_eur":{"type":"number","nullable":true},"daily_rate_limit":{"type":"number","nullable":true},"top_results_limit":{"type":"number"},"engagement_min_months":{"type":"number"},"features":{"type":"array","items":{"type":"string"}}},"required":["code","name","price_monthly_eur","credits_per_month","overage_price_eur","daily_rate_limit","top_results_limit","engagement_min_months","features"]},"InvoiceEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"organisation_id":{"$ref":"#/components/schemas/ObjectId"},"organisation":{"type":"string","example":"/organisations/507f1f77bcf86cd799439011"},"organisation_plan_id":{"type":"object","nullable":true,"description":"OrganisationPlan maillon this invoice covers. Nullable for back-fills."},"payment_id":{"type":"string","description":"Mollie payment id that triggered the invoice. Unique — same payment delivered twice via webhook retry creates one invoice."},"provider":{"type":"string","enum":["pennylane"]},"status":{"type":"string","enum":["pending","issued","failed"]},"provider_invoice_number":{"type":"object","nullable":true,"description":"Pennylane's invoice_number (e.g. F-2026-04101020). Null while status=pending or failed."},"pdf_url":{"type":"object","nullable":true,"description":"Pennylane's hosted PDF URL. Null until the invoice is issued."},"total_amount_eur":{"type":"string","description":"Gross amount including VAT, decimal string in EUR (e.g. \"490.00\")."},"vat_amount_eur":{"type":"object","nullable":true,"description":"VAT amount, decimal string in EUR."},"reason":{"type":"object","nullable":true,"description":"Free-form context, e.g. failure reason when status=failed."}},"required":["id","created_at","updated_at","organisation_id","organisation","organisation_plan_id","payment_id","provider","status","provider_invoice_number","pdf_url","total_amount_eur","vat_amount_eur","reason"]},"RoleEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"name":{"type":"string"},"permissions":{"type":"number"},"rank":{"type":"number"}},"required":["id","created_at","updated_at","name","permissions","rank"]},"ProjectEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"team":{"type":"string","example":"/organisations/507f1f77bcf86cd799439011/teams/507f1f77bcf86cd799439011"},"name":{"type":"string"},"description":{"type":"string"},"active":{"type":"boolean"},"start_date":{"format":"date-time","type":"string"},"end_date":{"format":"date-time","type":"string"}},"required":["id","created_at","updated_at","team","name","description","active","start_date","end_date"]},"PostProjectDto":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"active":{"type":"boolean"},"start_date":{"format":"date-time","type":"string"},"end_date":{"format":"date-time","type":"string"}},"required":["name","description","active","start_date","end_date"]},"PutProjectDto":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"active":{"type":"boolean"},"start_date":{"format":"date-time","type":"string"},"end_date":{"format":"date-time","type":"string"}},"required":["name","description","active","start_date","end_date"]},"Auth0Entity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"auth0_id":{"type":"string","nullable":true},"token":{"type":"string","nullable":true},"user":{"type":"string","example":"/users/507f1f77bcf86cd799439011"},"data_created_at":{"format":"date-time","type":"string"},"connection_logs":{"type":"array","items":{"format":"date-time","type":"string"}},"access_token":{"type":"string","nullable":true}},"required":["id","created_at","updated_at","auth0_id","token","user","data_created_at","connection_logs","access_token"]},"ProgramEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"organisation":{"type":"string","example":"/organisations/507f1f77bcf86cd799439011"},"name":{"type":"string"},"courses":{"$ref":"#/components/schemas/HydraRelation"}},"required":["id","created_at","updated_at","organisation","name","courses"]},"PostProgramDto":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]},"PutProgramDto":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]},"SkillEvaluation":{"type":"object","properties":{}},"EvaluationEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"date":{"format":"date-time","type":"string"},"type":{"type":"string","enum":["Bilan annuel","Bilan trimestriel","Évaluation de compétence","Debrief de projet"]},"status":{"type":"string","enum":["draft","done"]},"issuer":{"type":"string","example":"/users/507f1f77bcf86cd799439011"},"user":{"type":"string","example":"/users/507f1f77bcf86cd799439011"},"skills":{"type":"array","items":{"$ref":"#/components/schemas/SkillEvaluation"}},"comment":{"type":"object","nullable":true}},"required":["id","created_at","updated_at","date","type","status","issuer","user","skills","comment"]},"PostEvaluationDto":{"type":"object","properties":{"date":{"format":"date-time","type":"string","description":"Evaluation's date","example":"2026-06-15T08:27:55.147Z","default":"2026-06-15T08:27:55.147Z"},"type":{"type":"string","enum":["Bilan annuel","Bilan trimestriel","Évaluation de compétence","Debrief de projet"],"description":"Evaluation's type","example":"Bilan trimestriel"},"issuer_id":{"type":"string","description":"Evaluation's issuer","example":"507f1f77bcf86cd799439011"}},"required":["type","issuer_id"]},"SkillEvaluationDto":{"type":"object","properties":{"userTitle_id":{"type":"string","description":"SkillbergSkill's id to be evaluated","example":"507f1f77bcf86cd799439011"},"level":{"type":"number","description":"User's current level regarding this SkillbergSkill","example":0.66,"maximum":1,"minimum":0},"target_level":{"type":"object","description":"User's target level regarding this SkillbergSkill","example":0.77,"maximum":1,"minimum":0,"nullable":true},"target_date":{"type":"object","description":"User's target date to reach the target_level","example":"2026-01-21T23:27:47.044Z","nullable":true},"comment":{"type":"string","description":"Comment regarding this SkillbergSkill's evaluation","nullable":true}},"required":["userTitle_id","level"]},"PutEvaluationDto":{"type":"object","properties":{"date":{"format":"date-time","type":"string","description":"Evaluation's date","example":"2026-06-15T08:27:55.147Z","default":"2026-06-15T08:27:55.147Z"},"type":{"type":"string","enum":["Bilan annuel","Bilan trimestriel","Évaluation de compétence","Debrief de projet"],"description":"Evaluation's type","example":"Bilan trimestriel"},"issuer_id":{"type":"string","description":"Evaluation's issuer","example":"507f1f77bcf86cd799439011"},"status":{"type":"string","enum":["draft","done"],"description":"Evaluation's status","example":"draft"},"skills":{"description":"SkillbergSkills' array","type":"array","items":{"$ref":"#/components/schemas/SkillEvaluationDto"}},"comment":{"type":"object","description":"Comment regarding the evaluation","nullable":true}},"required":["type","issuer_id","status","skills"]},"CourseEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"organisation_id":{"example":"507f1f77bcf86cd799439011","allOf":[{"$ref":"#/components/schemas/ObjectId"}]},"name":{"type":"string"},"program_id":{"type":"object"},"skillSet":{"type":"object","example":"/courses/507f1f77bcf86cd799439011/skillSets/507f1f77bcf86cd799439011","nullable":true}},"required":["id","created_at","updated_at","organisation_id","name","skillSet"]},"PostCourseDto":{"type":"object","properties":{"name":{"type":"string"},"program_id":{"type":"object"}},"required":["name"]},"PutCourseDto":{"type":"object","properties":{"name":{"type":"string"},"program_id":{"type":"object"}},"required":["name"]},"TreatedDocumentEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"rawDocument":{"type":"string","example":"/rawDocuments/507f1f77bcf86cd799439011"},"user":{"type":"string","example":"/users/507f1f77bcf86cd799439011"}},"required":["id","created_at","updated_at","rawDocument","user"]},"PostUserLocationDto":{"type":"object","properties":{"address":{"type":"string","nullable":true},"postalCode":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"countryCode":{"type":"string","nullable":true},"region":{"type":"string","nullable":true}},"required":["address","postalCode","city","countryCode","region"]},"PostUserProfileDto":{"type":"object","properties":{"network":{"type":"string","nullable":true},"username":{"type":"string","nullable":true},"url":{"type":"string","nullable":true}},"required":["network","username","url"]},"PostUserBasicsDto":{"type":"object","properties":{"name":{"type":"string","nullable":true},"label":{"type":"string","nullable":true},"image":{"type":"string","nullable":true},"email":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"url":{"type":"string","nullable":true},"summary":{"type":"string","nullable":true},"location":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/PostUserLocationDto"}]},"profiles":{"type":"array","items":{"$ref":"#/components/schemas/PostUserProfileDto"}}},"required":["name","label","image","email","phone","url","summary","location","profiles"]},"PostTreatedWorkDto":{"type":"object","properties":{"summary":{"type":"string","nullable":true},"position":{"type":"string","nullable":true},"url":{"type":"string","nullable":true},"startDate":{"format":"date-time","type":"string","nullable":true},"endDate":{"format":"date-time","type":"string","nullable":true},"highlights":{"type":"array","items":{"type":"string"}},"name":{"type":"string","nullable":true}},"required":["summary","position","url","startDate","endDate","highlights","name"]},"PostTreatedVolunteerDto":{"type":"object","properties":{"summary":{"type":"string","nullable":true},"position":{"type":"string","nullable":true},"url":{"type":"string","nullable":true},"startDate":{"format":"date-time","type":"string","nullable":true},"endDate":{"format":"date-time","type":"string","nullable":true},"highlights":{"type":"array","items":{"type":"string"}},"organization":{"type":"string","nullable":true}},"required":["summary","position","url","startDate","endDate","highlights","organization"]},"PostTreatedEducationDto":{"type":"object","properties":{"institution":{"type":"string","nullable":true},"url":{"type":"string","nullable":true},"area":{"type":"string","nullable":true},"studyType":{"type":"string","nullable":true},"startDate":{"format":"date-time","type":"string","nullable":true},"endDate":{"format":"date-time","type":"string","nullable":true},"score":{"type":"string","nullable":true},"courses":{"type":"array","items":{"type":"string"}}},"required":["institution","url","area","studyType","startDate","endDate","score","courses"]},"PostUserAwardDto":{"type":"object","properties":{"title":{"type":"string","nullable":true},"date":{"format":"date-time","type":"string","nullable":true},"awarder":{"type":"string","nullable":true},"summary":{"type":"string","nullable":true}},"required":["title","date","awarder","summary"]},"PostUserCertificateDto":{"type":"object","properties":{"name":{"type":"string","nullable":true},"date":{"format":"date-time","type":"string","nullable":true},"url":{"type":"string","nullable":true},"issuer":{"type":"string","nullable":true}},"required":["name","date","url","issuer"]},"PostUserPublicationDto":{"type":"object","properties":{"name":{"type":"string","nullable":true},"publisher":{"type":"string","nullable":true},"releaseDate":{"format":"date-time","type":"string","nullable":true},"url":{"type":"string","nullable":true},"summary":{"type":"string","nullable":true}},"required":["name","publisher","releaseDate","url","summary"]},"PostTreatedSkillDto":{"type":"object","properties":{"name":{"type":"string","nullable":true},"level":{"type":"string","nullable":true},"keywords":{"type":"array","items":{"type":"string"}}},"required":["name","level","keywords"]},"PostUserLanguageDto":{"type":"object","properties":{"language":{"type":"string","nullable":true},"fluency":{"type":"string","nullable":true}},"required":["language","fluency"]},"PostTreatedInterestDto":{"type":"object","properties":{"name":{"type":"string","nullable":true},"keywords":{"type":"array","items":{"type":"string"}}},"required":["name","keywords"]},"PostUserReferenceDto":{"type":"object","properties":{"name":{"type":"string","nullable":true},"reference":{"type":"string","nullable":true}},"required":["name","reference"]},"PostTreatedProjectDto":{"type":"object","properties":{"name":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"highlights":{"type":"array","items":{"type":"string"}},"keywords":{"type":"array","items":{"type":"string"}},"startDate":{"format":"date-time","type":"string","nullable":true},"endDate":{"format":"date-time","type":"string","nullable":true},"url":{"type":"string","nullable":true},"roles":{"type":"array","items":{"type":"string"}},"entity":{"type":"string","nullable":true},"type":{"type":"string","nullable":true}},"required":["name","description","highlights","keywords","startDate","endDate","url","roles","entity","type"]},"PostTreatedJsonResumeDto":{"type":"object","properties":{"basics":{"$ref":"#/components/schemas/PostUserBasicsDto"},"work":{"type":"array","items":{"$ref":"#/components/schemas/PostTreatedWorkDto"}},"volunteer":{"type":"array","items":{"$ref":"#/components/schemas/PostTreatedVolunteerDto"}},"education":{"type":"array","items":{"$ref":"#/components/schemas/PostTreatedEducationDto"}},"awards":{"type":"array","items":{"$ref":"#/components/schemas/PostUserAwardDto"}},"certificates":{"type":"array","items":{"$ref":"#/components/schemas/PostUserCertificateDto"}},"publications":{"type":"array","items":{"$ref":"#/components/schemas/PostUserPublicationDto"}},"skills":{"type":"array","items":{"$ref":"#/components/schemas/PostTreatedSkillDto"}},"languages":{"type":"array","items":{"$ref":"#/components/schemas/PostUserLanguageDto"}},"interests":{"type":"array","items":{"$ref":"#/components/schemas/PostTreatedInterestDto"}},"references":{"type":"array","items":{"$ref":"#/components/schemas/PostUserReferenceDto"}},"projects":{"type":"array","items":{"$ref":"#/components/schemas/PostTreatedProjectDto"}}},"required":["basics","work","volunteer","education","awards","certificates","publications","skills","languages","interests","references","projects"]},"PostCorrectedTreatedDocumentDto":{"type":"object","properties":{"json_resume":{"$ref":"#/components/schemas/PostTreatedJsonResumeDto"}},"required":["json_resume"]},"CorrectedTreatedDocumentEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"treatedDocument":{"type":"string","example":"/treatedDocuments/507f1f77bcf86cd799439011"}},"required":["id","created_at","updated_at","treatedDocument"]},"PutCorrectedTreatedDocumentDto":{"type":"object","properties":{"json_resume":{"$ref":"#/components/schemas/PostTreatedJsonResumeDto"}},"required":["json_resume"]},"EnrichedDocumentEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"treatedDocument":{"type":"string","example":"/treatedDocuments/507f1f77bcf86cd799439011"}},"required":["id","created_at","updated_at","treatedDocument"]},"PostUserWorkDto":{"type":"object","properties":{"summary":{"type":"string","nullable":true},"position":{"type":"string","nullable":true},"url":{"type":"string","nullable":true},"startDate":{"format":"date-time","type":"string","nullable":true},"endDate":{"format":"date-time","type":"string","nullable":true},"highlights":{"type":"array","items":{"type":"string"}},"name":{"type":"string","nullable":true},"sector_uuid":{"type":"string","nullable":true},"job_uuid":{"type":"string","nullable":true}},"required":["summary","position","url","startDate","endDate","highlights","name","sector_uuid","job_uuid"]},"PropertyUsedDto":{"type":"object","properties":{"fieldsUsed":{"type":"array","items":{"type":"string"}},"recommendedAttributesUsed":{"type":"array","items":{"type":"string"}},"priority":{"type":"number","nullable":true}},"required":["fieldsUsed","recommendedAttributesUsed","priority"]},"SectorTitleNodeContextDto":{"type":"object","properties":{"yearsExperience":{"type":"number","nullable":true},"sectors":{"type":"object","nullable":true}},"required":["yearsExperience","sectors"]},"SectorRecommendationDto":{"type":"object","properties":{"cosineScore":{"type":"number"},"nodeUuid":{"type":"string"},"propertyUsed":{"$ref":"#/components/schemas/PropertyUsedDto"},"context":{"$ref":"#/components/schemas/SectorTitleNodeContextDto"}},"required":["cosineScore","nodeUuid","propertyUsed","context"]},"SectorRefDto":{"type":"object","properties":{"UUID":{"type":"string"},"name":{"type":"string"}},"required":["UUID","name"]},"JobNodeContextDto":{"type":"object","properties":{"yearsExperience":{"type":"number","nullable":true},"sectors":{"nullable":true,"type":"array","items":{"$ref":"#/components/schemas/SectorRefDto"}}},"required":["yearsExperience","sectors"]},"JobRecommendationDto":{"type":"object","properties":{"cosineScore":{"type":"number"},"nodeUuid":{"type":"string"},"propertyUsed":{"$ref":"#/components/schemas/PropertyUsedDto"},"context":{"$ref":"#/components/schemas/JobNodeContextDto"}},"required":["cosineScore","nodeUuid","propertyUsed","context"]},"TitleRecommendationDto":{"type":"object","properties":{"cosineScore":{"type":"number"},"nodeUuid":{"type":"string"},"propertyUsed":{"$ref":"#/components/schemas/PropertyUsedDto"},"context":{"$ref":"#/components/schemas/SectorTitleNodeContextDto"}},"required":["cosineScore","nodeUuid","propertyUsed","context"]},"EnrichedWorkDto":{"type":"object","properties":{"original":{"$ref":"#/components/schemas/PostUserWorkDto"},"recommendedSectors":{"type":"array","items":{"$ref":"#/components/schemas/SectorRecommendationDto"}},"recommendedJobs":{"type":"array","items":{"$ref":"#/components/schemas/JobRecommendationDto"}},"recommendedTitles":{"type":"array","items":{"$ref":"#/components/schemas/TitleRecommendationDto"}}},"required":["original","recommendedSectors","recommendedJobs","recommendedTitles"]},"PostUserVolunteerDto":{"type":"object","properties":{"summary":{"type":"string","nullable":true},"position":{"type":"string","nullable":true},"url":{"type":"string","nullable":true},"startDate":{"format":"date-time","type":"string","nullable":true},"endDate":{"format":"date-time","type":"string","nullable":true},"highlights":{"type":"array","items":{"type":"string"}},"organization":{"type":"string","nullable":true},"sector_uuid":{"type":"string","nullable":true},"job_uuid":{"type":"string","nullable":true}},"required":["summary","position","url","startDate","endDate","highlights","organization","sector_uuid","job_uuid"]},"EnrichedVolunteerDto":{"type":"object","properties":{"original":{"$ref":"#/components/schemas/PostUserVolunteerDto"},"recommendedSectors":{"type":"array","items":{"$ref":"#/components/schemas/SectorRecommendationDto"}},"recommendedJobs":{"type":"array","items":{"$ref":"#/components/schemas/JobRecommendationDto"}},"recommendedTitles":{"type":"array","items":{"$ref":"#/components/schemas/TitleRecommendationDto"}}},"required":["original","recommendedSectors","recommendedJobs","recommendedTitles"]},"PostUserEducationDto":{"type":"object","properties":{"institution":{"type":"string","nullable":true},"url":{"type":"string","nullable":true},"area":{"type":"string","nullable":true},"studyType":{"type":"string","nullable":true},"startDate":{"format":"date-time","type":"string","nullable":true},"endDate":{"format":"date-time","type":"string","nullable":true},"score":{"type":"string","nullable":true},"courses":{"type":"array","items":{"type":"string"}},"sector_uuid":{"type":"string","nullable":true},"job_uuid":{"type":"string","nullable":true}},"required":["institution","url","area","studyType","startDate","endDate","score","courses","sector_uuid","job_uuid"]},"EnrichedEducationDto":{"type":"object","properties":{"original":{"$ref":"#/components/schemas/PostUserEducationDto"},"recommendedSectors":{"type":"array","items":{"$ref":"#/components/schemas/SectorRecommendationDto"}},"recommendedJobs":{"type":"array","items":{"$ref":"#/components/schemas/JobRecommendationDto"}},"recommendedTitles":{"type":"array","items":{"$ref":"#/components/schemas/TitleRecommendationDto"}}},"required":["original","recommendedSectors","recommendedJobs","recommendedTitles"]},"PostUserSkillDto":{"type":"object","properties":{"name":{"type":"string","nullable":true},"level":{"type":"string","nullable":true},"keywords":{"type":"array","items":{"type":"string"}},"sector_uuid":{"type":"string","nullable":true},"job_uuid":{"type":"string","nullable":true}},"required":["name","level","keywords","sector_uuid","job_uuid"]},"EnrichedSkillDto":{"type":"object","properties":{"original":{"$ref":"#/components/schemas/PostUserSkillDto"},"recommendedSectors":{"type":"array","items":{"$ref":"#/components/schemas/SectorRecommendationDto"}},"recommendedJobs":{"type":"array","items":{"$ref":"#/components/schemas/JobRecommendationDto"}},"recommendedTitles":{"type":"array","items":{"$ref":"#/components/schemas/TitleRecommendationDto"}}},"required":["original","recommendedSectors","recommendedJobs","recommendedTitles"]},"PostUserInterestDto":{"type":"object","properties":{"name":{"type":"string","nullable":true},"keywords":{"type":"array","items":{"type":"string"}},"sector_uuid":{"type":"string","nullable":true},"job_uuid":{"type":"string","nullable":true}},"required":["name","keywords","sector_uuid","job_uuid"]},"EnrichedInterestDto":{"type":"object","properties":{"original":{"$ref":"#/components/schemas/PostUserInterestDto"},"recommendedSectors":{"type":"array","items":{"$ref":"#/components/schemas/SectorRecommendationDto"}},"recommendedJobs":{"type":"array","items":{"$ref":"#/components/schemas/JobRecommendationDto"}},"recommendedTitles":{"type":"array","items":{"$ref":"#/components/schemas/TitleRecommendationDto"}}},"required":["original","recommendedSectors","recommendedJobs","recommendedTitles"]},"PostUserProjectDto":{"type":"object","properties":{"name":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"highlights":{"type":"array","items":{"type":"string"}},"keywords":{"type":"array","items":{"type":"string"}},"startDate":{"format":"date-time","type":"string","nullable":true},"endDate":{"format":"date-time","type":"string","nullable":true},"url":{"type":"string","nullable":true},"roles":{"type":"array","items":{"type":"string"}},"entity":{"type":"string","nullable":true},"type":{"type":"string","nullable":true},"sector_uuid":{"type":"string","nullable":true},"job_uuid":{"type":"string","nullable":true}},"required":["name","description","highlights","keywords","startDate","endDate","url","roles","entity","type","sector_uuid","job_uuid"]},"EnrichedProjectDto":{"type":"object","properties":{"original":{"$ref":"#/components/schemas/PostUserProjectDto"},"recommendedSectors":{"type":"array","items":{"$ref":"#/components/schemas/SectorRecommendationDto"}},"recommendedJobs":{"type":"array","items":{"$ref":"#/components/schemas/JobRecommendationDto"}},"recommendedTitles":{"type":"array","items":{"$ref":"#/components/schemas/TitleRecommendationDto"}}},"required":["original","recommendedSectors","recommendedJobs","recommendedTitles"]},"EnrichedJsonResumeDto":{"type":"object","properties":{"basics":{"$ref":"#/components/schemas/PostUserBasicsDto"},"work":{"type":"array","items":{"$ref":"#/components/schemas/EnrichedWorkDto"}},"volunteer":{"type":"array","items":{"$ref":"#/components/schemas/EnrichedVolunteerDto"}},"education":{"type":"array","items":{"$ref":"#/components/schemas/EnrichedEducationDto"}},"certificates":{"type":"array","items":{"$ref":"#/components/schemas/PostUserCertificateDto"}},"publications":{"type":"array","items":{"$ref":"#/components/schemas/PostUserPublicationDto"}},"skills":{"type":"array","items":{"$ref":"#/components/schemas/EnrichedSkillDto"}},"languages":{"type":"array","items":{"$ref":"#/components/schemas/PostUserLanguageDto"}},"interests":{"type":"array","items":{"$ref":"#/components/schemas/EnrichedInterestDto"}},"projects":{"type":"array","items":{"$ref":"#/components/schemas/EnrichedProjectDto"}},"references":{"type":"array","items":{"$ref":"#/components/schemas/PostUserReferenceDto"}},"awards":{"type":"array","items":{"$ref":"#/components/schemas/PostUserAwardDto"}}},"required":["basics","work","volunteer","education","certificates","publications","skills","languages","interests","projects","references","awards"]},"SectorNodeDto":{"type":"object","properties":{"UUID":{"type":"string"},"labels":{"type":"array","items":{"type":"string"}},"name":{"type":"string"}},"required":["UUID","labels","name"]},"JobNodeDto":{"type":"object","properties":{"UUID":{"type":"string"},"labels":{"type":"array","items":{"type":"string"}},"name":{"type":"string"},"description":{"type":"string"}},"required":["UUID","labels","name","description"]},"TitleNodeDto":{"type":"object","properties":{"UUID":{"type":"string"},"labels":{"type":"array","items":{"type":"string"}},"name":{"type":"string"},"description":{"type":"string"},"proficiency_description":{"type":"string"},"proficiency_level_num":{"type":"number"}},"required":["UUID","labels","name","description","proficiency_description","proficiency_level_num"]},"NodesDto":{"type":"object","properties":{"sector":{"type":"array","items":{"$ref":"#/components/schemas/SectorNodeDto"}},"job":{"type":"array","items":{"$ref":"#/components/schemas/JobNodeDto"}},"title":{"type":"array","items":{"$ref":"#/components/schemas/TitleNodeDto"}}},"required":["sector","job","title"]},"PostCorrectedEnrichedDocumentDto":{"type":"object","properties":{"json_resume":{"$ref":"#/components/schemas/EnrichedJsonResumeDto"},"nodes":{"$ref":"#/components/schemas/NodesDto"}},"required":["json_resume","nodes"]},"CorrectedEnrichedDocumentEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"enrichedDocument":{"type":"string","example":"/enrichedDocuments/507f1f77bcf86cd799439011"}},"required":["id","created_at","updated_at","enrichedDocument"]},"PutCorrectedEnrichedDocumentDto":{"type":"object","properties":{"json_resume":{"$ref":"#/components/schemas/EnrichedJsonResumeDto"},"nodes":{"$ref":"#/components/schemas/NodesDto"}},"required":["json_resume","nodes"]},"MissionEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"project":{"type":"string","example":"/organisations/507f1f77bcf86cd799439011/teams/507f1f77bcf86cd799439011/projects/507f1f77bcf86cd799439011"},"name":{"type":"string"},"description":{"type":"string"},"start_date":{"format":"date-time","type":"string"},"end_date":{"format":"date-time","type":"string"},"priority":{"type":"string","enum":["low","medium","high"]},"size":{"type":"string","enum":["small","medium","large"]}},"required":["id","created_at","updated_at","project","name","description","start_date","end_date","priority","size"]},"PostMissionDto":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"start_date":{"format":"date-time","type":"string"},"end_date":{"format":"date-time","type":"string"},"priority":{"type":"string","enum":["low","medium","high"]},"size":{"type":"string","enum":["small","medium","large"]}},"required":["name","description","start_date","end_date","priority","size"]},"PutMissionDto":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"start_date":{"format":"date-time","type":"string"},"end_date":{"format":"date-time","type":"string"},"priority":{"type":"string","enum":["low","medium","high"]},"size":{"type":"string","enum":["small","medium","large"]}},"required":["name","description","start_date","end_date","priority","size"]},"UserWorkEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"summary":{"type":"string","nullable":true},"position":{"type":"string","nullable":true},"url":{"type":"string","nullable":true},"startDate":{"format":"date-time","type":"string","nullable":true},"endDate":{"format":"date-time","type":"string","nullable":true},"highlights":{"type":"array","items":{"type":"string"}},"name":{"type":"string","nullable":true},"sector_uuid":{"type":"string","nullable":true},"job_uuid":{"type":"string","nullable":true},"user":{"type":"string","example":"/users/507f1f77bcf86cd799439011"}},"required":["id","created_at","updated_at","summary","position","url","startDate","endDate","highlights","name","sector_uuid","job_uuid","user"]},"PutUserWorkDto":{"type":"object","properties":{"summary":{"type":"string","nullable":true},"position":{"type":"string","nullable":true},"url":{"type":"string","nullable":true},"startDate":{"format":"date-time","type":"string","nullable":true},"endDate":{"format":"date-time","type":"string","nullable":true},"highlights":{"type":"array","items":{"type":"string"}},"name":{"type":"string","nullable":true},"sector_uuid":{"type":"string","nullable":true},"job_uuid":{"type":"string","nullable":true}},"required":["summary","position","url","startDate","endDate","highlights","name","sector_uuid","job_uuid"]},"UserProjectEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"name":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"highlights":{"type":"array","items":{"type":"string"}},"keywords":{"type":"array","items":{"type":"string"}},"startDate":{"format":"date-time","type":"string","nullable":true},"endDate":{"format":"date-time","type":"string","nullable":true},"url":{"type":"string","nullable":true},"roles":{"type":"array","items":{"type":"string"}},"entity":{"type":"string","nullable":true},"type":{"type":"string","nullable":true},"sector_uuid":{"type":"string","nullable":true},"job_uuid":{"type":"string","nullable":true},"user":{"type":"string","example":"/users/507f1f77bcf86cd799439011"}},"required":["id","created_at","updated_at","name","description","highlights","keywords","startDate","endDate","url","roles","entity","type","sector_uuid","job_uuid","user"]},"PutUserProjectDto":{"type":"object","properties":{"name":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"highlights":{"type":"array","items":{"type":"string"}},"keywords":{"type":"array","items":{"type":"string"}},"startDate":{"format":"date-time","type":"string","nullable":true},"endDate":{"format":"date-time","type":"string","nullable":true},"url":{"type":"string","nullable":true},"roles":{"type":"array","items":{"type":"string"}},"entity":{"type":"string","nullable":true},"type":{"type":"string","nullable":true},"sector_uuid":{"type":"string","nullable":true},"job_uuid":{"type":"string","nullable":true}},"required":["name","description","highlights","keywords","startDate","endDate","url","roles","entity","type","sector_uuid","job_uuid"]},"UserVolunteerEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"summary":{"type":"string","nullable":true},"position":{"type":"string","nullable":true},"url":{"type":"string","nullable":true},"startDate":{"format":"date-time","type":"string","nullable":true},"endDate":{"format":"date-time","type":"string","nullable":true},"highlights":{"type":"array","items":{"type":"string"}},"organization":{"type":"string","nullable":true},"sector_uuid":{"type":"string","nullable":true},"job_uuid":{"type":"string","nullable":true},"user":{"type":"string","example":"/users/507f1f77bcf86cd799439011"}},"required":["id","created_at","updated_at","summary","position","url","startDate","endDate","highlights","organization","sector_uuid","job_uuid","user"]},"PutUserVolunteerDto":{"type":"object","properties":{"summary":{"type":"string","nullable":true},"position":{"type":"string","nullable":true},"url":{"type":"string","nullable":true},"startDate":{"format":"date-time","type":"string","nullable":true},"endDate":{"format":"date-time","type":"string","nullable":true},"highlights":{"type":"array","items":{"type":"string"}},"organization":{"type":"string","nullable":true},"sector_uuid":{"type":"string","nullable":true},"job_uuid":{"type":"string","nullable":true}},"required":["summary","position","url","startDate","endDate","highlights","organization","sector_uuid","job_uuid"]},"UserAwardEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"title":{"type":"string","nullable":true},"date":{"format":"date-time","type":"string","nullable":true},"awarder":{"type":"string","nullable":true},"summary":{"type":"string","nullable":true},"user":{"type":"string","example":"/users/507f1f77bcf86cd799439011"}},"required":["id","created_at","updated_at","title","date","awarder","summary","user"]},"PutUserAwardDto":{"type":"object","properties":{"title":{"type":"string","nullable":true},"date":{"format":"date-time","type":"string","nullable":true},"awarder":{"type":"string","nullable":true},"summary":{"type":"string","nullable":true}},"required":["title","date","awarder","summary"]},"UserSkillEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"name":{"type":"string","nullable":true},"level":{"type":"string","nullable":true},"keywords":{"type":"array","items":{"type":"string"}},"sector_uuid":{"type":"string","nullable":true},"job_uuid":{"type":"string","nullable":true},"user":{"type":"string","example":"/users/507f1f77bcf86cd799439011"}},"required":["id","created_at","updated_at","name","level","keywords","sector_uuid","job_uuid","user"]},"PutUserSkillDto":{"type":"object","properties":{"name":{"type":"string","nullable":true},"level":{"type":"string","nullable":true},"keywords":{"type":"array","items":{"type":"string"}},"sector_uuid":{"type":"string","nullable":true},"job_uuid":{"type":"string","nullable":true}},"required":["name","level","keywords","sector_uuid","job_uuid"]},"UserInterestEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"name":{"type":"string","nullable":true},"keywords":{"type":"array","items":{"type":"string"}},"sector_uuid":{"type":"string","nullable":true},"job_uuid":{"type":"string","nullable":true},"user":{"type":"string","example":"/users/507f1f77bcf86cd799439011"}},"required":["id","created_at","updated_at","name","keywords","sector_uuid","job_uuid","user"]},"PutUserInterestDto":{"type":"object","properties":{"name":{"type":"string","nullable":true},"keywords":{"type":"array","items":{"type":"string"}},"sector_uuid":{"type":"string","nullable":true},"job_uuid":{"type":"string","nullable":true}},"required":["name","keywords","sector_uuid","job_uuid"]},"UserLanguageEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"language":{"type":"string","nullable":true},"fluency":{"type":"string","nullable":true},"user":{"type":"string","example":"/users/507f1f77bcf86cd799439011"}},"required":["id","created_at","updated_at","language","fluency","user"]},"PutUserLanguageDto":{"type":"object","properties":{"language":{"type":"string","nullable":true},"fluency":{"type":"string","nullable":true}},"required":["language","fluency"]},"UserEducationEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"institution":{"type":"string","nullable":true},"url":{"type":"string","nullable":true},"area":{"type":"string","nullable":true},"studyType":{"type":"string","nullable":true},"startDate":{"format":"date-time","type":"string","nullable":true},"endDate":{"format":"date-time","type":"string","nullable":true},"score":{"type":"string","nullable":true},"courses":{"type":"array","items":{"type":"string"}},"sector_uuid":{"type":"string","nullable":true},"job_uuid":{"type":"string","nullable":true},"user":{"type":"string","example":"/users/507f1f77bcf86cd799439011"}},"required":["id","created_at","updated_at","institution","url","area","studyType","startDate","endDate","score","courses","sector_uuid","job_uuid","user"]},"PutUserEducationDto":{"type":"object","properties":{"institution":{"type":"string","nullable":true},"url":{"type":"string","nullable":true},"area":{"type":"string","nullable":true},"studyType":{"type":"string","nullable":true},"startDate":{"format":"date-time","type":"string","nullable":true},"endDate":{"format":"date-time","type":"string","nullable":true},"score":{"type":"string","nullable":true},"courses":{"type":"array","items":{"type":"string"}},"sector_uuid":{"type":"string","nullable":true},"job_uuid":{"type":"string","nullable":true}},"required":["institution","url","area","studyType","startDate","endDate","score","courses","sector_uuid","job_uuid"]},"UserReferenceEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"name":{"type":"string","nullable":true},"reference":{"type":"string","nullable":true},"user":{"type":"string","example":"/users/507f1f77bcf86cd799439011"}},"required":["id","created_at","updated_at","name","reference","user"]},"PutUserReferenceDto":{"type":"object","properties":{"name":{"type":"string","nullable":true},"reference":{"type":"string","nullable":true}},"required":["name","reference"]},"UserCertificateEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"name":{"type":"string","nullable":true},"date":{"format":"date-time","type":"string","nullable":true},"url":{"type":"string","nullable":true},"issuer":{"type":"string","nullable":true},"user":{"type":"string","example":"/users/507f1f77bcf86cd799439011"}},"required":["id","created_at","updated_at","name","date","url","issuer","user"]},"PutUserCertificateDto":{"type":"object","properties":{"name":{"type":"string","nullable":true},"date":{"format":"date-time","type":"string","nullable":true},"url":{"type":"string","nullable":true},"issuer":{"type":"string","nullable":true}},"required":["name","date","url","issuer"]},"UserPublicationEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"name":{"type":"string","nullable":true},"publisher":{"type":"string","nullable":true},"releaseDate":{"format":"date-time","type":"string","nullable":true},"url":{"type":"string","nullable":true},"summary":{"type":"string","nullable":true},"user":{"type":"string","example":"/users/507f1f77bcf86cd799439011"}},"required":["id","created_at","updated_at","name","publisher","releaseDate","url","summary","user"]},"PutUserPublicationDto":{"type":"object","properties":{"name":{"type":"string","nullable":true},"publisher":{"type":"string","nullable":true},"releaseDate":{"format":"date-time","type":"string","nullable":true},"url":{"type":"string","nullable":true},"summary":{"type":"string","nullable":true}},"required":["name","publisher","releaseDate","url","summary"]},"UserTitleEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"title_uuid":{"type":"string","example":"/skillbergAi/titles/28cb3ab4-3781-4061-9bae-2ba2c34bad6d"},"user":{"type":"string","example":"/users/507f1f77bcf86cd799439011"}},"required":["id","created_at","updated_at","title_uuid","user"]},"PostUserTitleDto":{"type":"object","properties":{"title_uuid":{"type":"string"},"alias":{"type":"string"},"level":{"type":"number"}},"required":["title_uuid","alias","level"]},"PutUserTitleDto":{"type":"object","properties":{"title_uuid":{"type":"string"},"alias":{"type":"string"},"level":{"type":"number"}},"required":["title_uuid","alias","level"]},"UsageSummaryDto":{"type":"object","properties":{"from":{"type":"string","description":"Window start (ISO-8601)."},"to":{"type":"string","description":"Window end (ISO-8601, exclusive)."},"total_calls":{"type":"number","description":"Total API calls in the window."},"total_credits":{"type":"number","description":"Total credits consumed in the window."},"avg_latency_ms":{"type":"number","description":"Mean duration in milliseconds across successful calls only (status < 400). 0 if no successful calls."},"error_rate":{"type":"number","description":"Fraction of calls that returned a 4xx/5xx (0..1)."}},"required":["from","to","total_calls","total_credits","avg_latency_ms","error_rate"]},"UsageDailyEntryDto":{"type":"object","properties":{"date":{"type":"string","description":"Day bucket (ISO date YYYY-MM-DD)."},"calls":{"type":"number","description":"Calls for the day."},"credits":{"type":"number","description":"Credits consumed for the day."}},"required":["date","calls","credits"]},"UsageTopRouteDto":{"type":"object","properties":{"path":{"type":"string","description":"Canonical route path (without query string)."},"method":{"type":"string","description":"HTTP method."},"calls":{"type":"number","description":"Calls for this route in the window."},"credits":{"type":"number","description":"Credits consumed by this route in the window."}},"required":["path","method","calls","credits"]},"UsageByKeyEntryDto":{"type":"object","properties":{"apiKey_id":{"type":"string","description":"ApiKey _id."},"name":{"type":"string","description":"Human-readable name set by the org admin."},"origin":{"type":"string","description":"Provenance of the key: 'api' (public API) or 'mcp' (Claude MCP connector).","enum":["api","mcp"]},"calls":{"type":"number","description":"Calls for this key in the window."},"credits":{"type":"number","description":"Credits consumed by this key in the window."}},"required":["apiKey_id","name","origin","calls","credits"]},"UsageByFamilyEntryDto":{"type":"object","properties":{"family":{"type":"string","description":"Route family (consultation | analyse | intelligence)."},"calls":{"type":"number","description":"Calls for this family in the window."},"credits":{"type":"number","description":"Credits consumed by this family in the window."}},"required":["family","calls","credits"]},"SonarUserEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"user":{"type":"string","example":"/users/507f1f77bcf86cd799439011"},"onboarded_at":{"format":"date-time","type":"string","nullable":true},"role":{"type":"string","nullable":true}},"required":["id","created_at","updated_at","user","onboarded_at","role"]},"PatchSonarUserDto":{"type":"object","properties":{"onboarded_at":{"format":"date-time","type":"string","nullable":true},"role":{"type":"string","nullable":true}}},"BillingAddressEntity":{"type":"object","properties":{"line1":{"type":"string"},"line2":{"type":"string","nullable":true},"city":{"type":"string"},"postal_code":{"type":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code (e.g. FR, BE, DE)","example":"FR"},"vat_number":{"type":"string","nullable":true}},"required":["line1","line2","city","postal_code","country","vat_number"]},"PaymentOrganisationEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"organisation_id":{"$ref":"#/components/schemas/ObjectId"},"organisation":{"type":"string","example":"/organisations/507f1f77bcf86cd799439011"},"legal_name":{"type":"string","nullable":true,"description":"Legal/registered company name used on invoices and PSP records. Null falls back to Organisation.name in the invoice generator."},"siret":{"type":"string","nullable":true,"description":"French SIRET (14-digit company registration). Validated softly as a non-empty string; tighter format check lives in the invoice generator once VAT rules expand."},"billing_email":{"type":"string","nullable":true,"description":"Email used for billing notifications and invoice delivery."},"billing_address":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/BillingAddressEntity"}]},"payment_provider":{"type":"string","nullable":true,"enum":["paddle","stripe","mollie","manual"],"description":"Active payment provider for this organisation. Null until the first billing action lands."},"payment_customer_id":{"type":"string","nullable":true,"description":"Provider-side customer ID (Mollie/Stripe/...). Lazy-created on first billing action. Read-only — managed by Bummock through link-mollie-customer."}},"required":["id","created_at","updated_at","organisation_id","organisation","legal_name","siret","billing_email","billing_address","payment_provider","payment_customer_id"]},"PutPaymentOrganisationDto":{"type":"object","properties":{"legal_name":{"type":"string","nullable":true,"description":"Legal/registered company name used on invoices and PSP records. Null falls back to Organisation.name in the invoice generator."},"siret":{"type":"string","nullable":true,"description":"French SIRET (14-digit company registration). Validated softly as a non-empty string; tighter format check lives in the invoice generator once VAT rules expand."},"billing_email":{"type":"string","nullable":true,"description":"Email used for billing notifications and invoice delivery."},"billing_address":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/BillingAddressEntity"}]}},"required":["legal_name","siret","billing_email","billing_address"]},"PatchPaymentOrganisationDto":{"type":"object","properties":{"legal_name":{"type":"string","nullable":true,"description":"Legal/registered company name used on invoices and PSP records. Null falls back to Organisation.name in the invoice generator."},"siret":{"type":"string","nullable":true,"description":"French SIRET (14-digit company registration). Validated softly as a non-empty string; tighter format check lives in the invoice generator once VAT rules expand."},"billing_email":{"type":"string","nullable":true,"description":"Email used for billing notifications and invoice delivery."},"billing_address":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/BillingAddressEntity"}]}}},"OrganizationSubEntity":{"type":"object","properties":{"name":{"type":"string","nullable":true},"url":{"type":"string","nullable":true},"description":{"type":"string","nullable":true}},"required":["name","url","description"]},"PostalAddressSubEntity":{"type":"object","properties":{"street_address":{"type":"string","nullable":true},"address_locality":{"type":"string","nullable":true},"address_region":{"type":"string","nullable":true},"postal_code":{"type":"string","nullable":true},"address_country":{"type":"string","nullable":true}},"required":["street_address","address_locality","address_region","postal_code","address_country"]},"PlaceSubEntity":{"type":"object","properties":{"name":{"type":"string","nullable":true},"address":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/PostalAddressSubEntity"}]}},"required":["name","address"]},"MonetaryAmountSubEntity":{"type":"object","properties":{"currency":{"type":"string","nullable":true},"value":{"type":"number","nullable":true},"min_value":{"type":"number","nullable":true},"max_value":{"type":"number","nullable":true}},"required":["currency","value","min_value","max_value"]},"EducationalOccupationalCredentialSubEntity":{"type":"object","properties":{"name":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"credential_category":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"recognized_by":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/OrganizationSubEntity"}]}},"required":["name","description","credential_category","about","recognized_by"]},"OccupationalExperienceRequirementsSubEntity":{"type":"object","properties":{"months_of_experience":{"type":"number","nullable":true},"description":{"type":"string","nullable":true}},"required":["months_of_experience","description"]},"SkillSubEntity":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string","nullable":true},"type":{"type":"string","nullable":true,"enum":["softskill","knowledge","ability"]},"level":{"type":"string","nullable":true,"enum":["novice","intermediate","expert"]},"keywords":{"type":"array","items":{"type":"string"}}},"required":["name","description","type","level"]},"ContactPointSubEntity":{"type":"object","properties":{"contact_type":{"type":"string","nullable":true},"email":{"type":"string","nullable":true},"telephone":{"type":"string","nullable":true}},"required":["contact_type","email","telephone"]},"JobPostingEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"title":{"type":"string","description":"Job title"},"description":{"type":"string","description":"Job description","nullable":true},"alternate_name":{"description":"Alternative job titles","type":"array","items":{"type":"string"}},"identifier":{"type":"string","description":"Unique identifier (slug, UUID, ...)","nullable":true},"date_posted":{"format":"date-time","type":"string","description":"Publication date","nullable":true},"valid_through":{"format":"date-time","type":"string","description":"Posting expiration date","nullable":true},"hiring_organization":{"description":"Recruiting company","nullable":true,"allOf":[{"$ref":"#/components/schemas/OrganizationSubEntity"}]},"employment_unit":{"description":"Department / unit concerned","nullable":true,"allOf":[{"$ref":"#/components/schemas/OrganizationSubEntity"}]},"job_location":{"description":"Workplace","nullable":true,"allOf":[{"$ref":"#/components/schemas/PlaceSubEntity"}]},"job_location_type":{"type":"string","description":"Remote/work arrangement type, e.g. TELECOMMUTE","nullable":true},"applicant_location_requirements":{"type":"string","description":"Allowed geographic areas (remote work)","nullable":true},"employment_type":{"type":"string","description":"Contract type (full-time, part-time, ...)","nullable":true},"work_hours":{"type":"string","description":"Typical hours","nullable":true},"job_immediate_start":{"type":"boolean","description":"Immediate start?","nullable":true},"job_start_date":{"format":"date-time","type":"string","description":"Expected start date","nullable":true},"total_job_openings":{"type":"number","description":"Number of open positions","nullable":true},"base_salary":{"description":"Base salary","nullable":true,"allOf":[{"$ref":"#/components/schemas/MonetaryAmountSubEntity"}]},"estimated_salary":{"description":"Estimated salary","nullable":true,"allOf":[{"$ref":"#/components/schemas/MonetaryAmountSubEntity"}]},"salary_currency":{"type":"string","description":"Main currency (ISO 4217)","nullable":true},"incentive_compensation":{"type":"string","description":"Bonuses / commissions","nullable":true},"job_benefits":{"type":"string","description":"Benefits","nullable":true},"industry":{"type":"string","description":"Industry sector","nullable":true},"occupational_category":{"type":"string","description":"Occupational category (O*NET, ISCO, ...)","nullable":true},"qualifications":{"description":"Required diploma / certification / qualifications","nullable":true,"allOf":[{"$ref":"#/components/schemas/EducationalOccupationalCredentialSubEntity"}]},"education_requirements":{"description":"Required education level","nullable":true,"allOf":[{"$ref":"#/components/schemas/EducationalOccupationalCredentialSubEntity"}]},"experience_requirements":{"description":"Required experience","nullable":true,"allOf":[{"$ref":"#/components/schemas/OccupationalExperienceRequirementsSubEntity"}]},"experience_in_place_of_education":{"type":"boolean","description":"Experience accepted in lieu of degree?","nullable":true},"responsibilities":{"description":"Job responsibilities / tasks","type":"array","items":{"type":"string"}},"skills":{"description":"Sought-after skills","type":"array","items":{"$ref":"#/components/schemas/SkillSubEntity"}},"physical_requirement":{"type":"string","description":"Physical requirements","nullable":true},"sensory_requirement":{"type":"string","description":"Sensory requirements","nullable":true},"security_clearance_requirement":{"type":"string","description":"Security clearances","nullable":true},"eligibility_to_work_requirement":{"type":"string","description":"Legal work conditions (visa, ...)","nullable":true},"employer_overview":{"type":"string","description":"Employer presentation","nullable":true},"special_commitments":{"type":"string","description":"Special commitments (VeteranCommit, ...)","nullable":true},"application_contact":{"description":"Contact point for the application","nullable":true,"allOf":[{"$ref":"#/components/schemas/ContactPointSubEntity"}]},"direct_apply":{"type":"boolean","description":"Does the posting allow direct application?","nullable":true},"relevant_occupation":{"type":"string","description":"Related occupation (free text)","nullable":true},"url":{"type":"string","description":"Canonical URL of the posting","nullable":true},"same_as":{"type":"string","description":"Reference URL for identity","nullable":true},"image":{"type":"string","description":"Image URL","nullable":true}},"required":["id","created_at","updated_at","title","description","identifier","date_posted","valid_through","hiring_organization","employment_unit","job_location","job_location_type","applicant_location_requirements","employment_type","work_hours","job_immediate_start","job_start_date","total_job_openings","base_salary","estimated_salary","salary_currency","incentive_compensation","job_benefits","industry","occupational_category","qualifications","education_requirements","experience_requirements","experience_in_place_of_education","physical_requirement","sensory_requirement","security_clearance_requirement","eligibility_to_work_requirement","employer_overview","special_commitments","application_contact","direct_apply","relevant_occupation","url","same_as","image"]},"PostOrganisationJobPostingDto":{"type":"object","properties":{"title":{"type":"string","description":"Job title"},"description":{"type":"string","description":"Job description","nullable":true},"alternate_name":{"description":"Alternative job titles","type":"array","items":{"type":"string"}},"identifier":{"type":"string","description":"Unique identifier (slug, UUID, ...)","nullable":true},"date_posted":{"format":"date-time","type":"string","description":"Publication date","nullable":true},"valid_through":{"format":"date-time","type":"string","description":"Posting expiration date","nullable":true},"hiring_organization":{"description":"Recruiting company","nullable":true,"allOf":[{"$ref":"#/components/schemas/OrganizationSubEntity"}]},"employment_unit":{"description":"Department / unit concerned","nullable":true,"allOf":[{"$ref":"#/components/schemas/OrganizationSubEntity"}]},"job_location":{"description":"Workplace","nullable":true,"allOf":[{"$ref":"#/components/schemas/PlaceSubEntity"}]},"job_location_type":{"type":"string","description":"Remote/work arrangement type, e.g. TELECOMMUTE","nullable":true},"applicant_location_requirements":{"type":"string","description":"Allowed geographic areas (remote work)","nullable":true},"employment_type":{"type":"string","description":"Contract type (full-time, part-time, ...)","nullable":true},"work_hours":{"type":"string","description":"Typical hours","nullable":true},"job_immediate_start":{"type":"boolean","description":"Immediate start?","nullable":true},"job_start_date":{"format":"date-time","type":"string","description":"Expected start date","nullable":true},"total_job_openings":{"type":"number","description":"Number of open positions","nullable":true},"base_salary":{"description":"Base salary","nullable":true,"allOf":[{"$ref":"#/components/schemas/MonetaryAmountSubEntity"}]},"estimated_salary":{"description":"Estimated salary","nullable":true,"allOf":[{"$ref":"#/components/schemas/MonetaryAmountSubEntity"}]},"salary_currency":{"type":"string","description":"Main currency (ISO 4217)","nullable":true},"incentive_compensation":{"type":"string","description":"Bonuses / commissions","nullable":true},"job_benefits":{"type":"string","description":"Benefits","nullable":true},"industry":{"type":"string","description":"Industry sector","nullable":true},"occupational_category":{"type":"string","description":"Occupational category (O*NET, ISCO, ...)","nullable":true},"qualifications":{"description":"Required diploma / certification / qualifications","nullable":true,"allOf":[{"$ref":"#/components/schemas/EducationalOccupationalCredentialSubEntity"}]},"education_requirements":{"description":"Required education level","nullable":true,"allOf":[{"$ref":"#/components/schemas/EducationalOccupationalCredentialSubEntity"}]},"experience_requirements":{"description":"Required experience","nullable":true,"allOf":[{"$ref":"#/components/schemas/OccupationalExperienceRequirementsSubEntity"}]},"experience_in_place_of_education":{"type":"boolean","description":"Experience accepted in lieu of degree?","nullable":true},"responsibilities":{"description":"Job responsibilities / tasks","type":"array","items":{"type":"string"}},"skills":{"description":"Sought-after skills","type":"array","items":{"$ref":"#/components/schemas/SkillSubEntity"}},"physical_requirement":{"type":"string","description":"Physical requirements","nullable":true},"sensory_requirement":{"type":"string","description":"Sensory requirements","nullable":true},"security_clearance_requirement":{"type":"string","description":"Security clearances","nullable":true},"eligibility_to_work_requirement":{"type":"string","description":"Legal work conditions (visa, ...)","nullable":true},"employer_overview":{"type":"string","description":"Employer presentation","nullable":true},"special_commitments":{"type":"string","description":"Special commitments (VeteranCommit, ...)","nullable":true},"application_contact":{"description":"Contact point for the application","nullable":true,"allOf":[{"$ref":"#/components/schemas/ContactPointSubEntity"}]},"direct_apply":{"type":"boolean","description":"Does the posting allow direct application?","nullable":true},"relevant_occupation":{"type":"string","description":"Related occupation (free text)","nullable":true},"url":{"type":"string","description":"Canonical URL of the posting","nullable":true},"same_as":{"type":"string","description":"Reference URL for identity","nullable":true},"image":{"type":"string","description":"Image URL","nullable":true},"career_id":{"type":"string","nullable":true},"status":{"type":"string","enum":["DRAFT","OPEN","CLOSED"]}},"required":["title","description","identifier","date_posted","valid_through","hiring_organization","employment_unit","job_location","job_location_type","applicant_location_requirements","employment_type","work_hours","job_immediate_start","job_start_date","total_job_openings","base_salary","estimated_salary","salary_currency","incentive_compensation","job_benefits","industry","occupational_category","qualifications","education_requirements","experience_requirements","experience_in_place_of_education","physical_requirement","sensory_requirement","security_clearance_requirement","eligibility_to_work_requirement","employer_overview","special_commitments","application_contact","direct_apply","relevant_occupation","url","same_as","image","career_id","status"]},"PutJobPostingDto":{"type":"object","properties":{"title":{"type":"string","description":"Job title"},"description":{"type":"string","description":"Job description","nullable":true},"alternate_name":{"description":"Alternative job titles","type":"array","items":{"type":"string"}},"identifier":{"type":"string","description":"Unique identifier (slug, UUID, ...)","nullable":true},"date_posted":{"format":"date-time","type":"string","description":"Publication date","nullable":true},"valid_through":{"format":"date-time","type":"string","description":"Posting expiration date","nullable":true},"hiring_organization":{"description":"Recruiting company","nullable":true,"allOf":[{"$ref":"#/components/schemas/OrganizationSubEntity"}]},"employment_unit":{"description":"Department / unit concerned","nullable":true,"allOf":[{"$ref":"#/components/schemas/OrganizationSubEntity"}]},"job_location":{"description":"Workplace","nullable":true,"allOf":[{"$ref":"#/components/schemas/PlaceSubEntity"}]},"job_location_type":{"type":"string","description":"Remote/work arrangement type, e.g. TELECOMMUTE","nullable":true},"applicant_location_requirements":{"type":"string","description":"Allowed geographic areas (remote work)","nullable":true},"employment_type":{"type":"string","description":"Contract type (full-time, part-time, ...)","nullable":true},"work_hours":{"type":"string","description":"Typical hours","nullable":true},"job_immediate_start":{"type":"boolean","description":"Immediate start?","nullable":true},"job_start_date":{"format":"date-time","type":"string","description":"Expected start date","nullable":true},"total_job_openings":{"type":"number","description":"Number of open positions","nullable":true},"base_salary":{"description":"Base salary","nullable":true,"allOf":[{"$ref":"#/components/schemas/MonetaryAmountSubEntity"}]},"estimated_salary":{"description":"Estimated salary","nullable":true,"allOf":[{"$ref":"#/components/schemas/MonetaryAmountSubEntity"}]},"salary_currency":{"type":"string","description":"Main currency (ISO 4217)","nullable":true},"incentive_compensation":{"type":"string","description":"Bonuses / commissions","nullable":true},"job_benefits":{"type":"string","description":"Benefits","nullable":true},"industry":{"type":"string","description":"Industry sector","nullable":true},"occupational_category":{"type":"string","description":"Occupational category (O*NET, ISCO, ...)","nullable":true},"qualifications":{"description":"Required diploma / certification / qualifications","nullable":true,"allOf":[{"$ref":"#/components/schemas/EducationalOccupationalCredentialSubEntity"}]},"education_requirements":{"description":"Required education level","nullable":true,"allOf":[{"$ref":"#/components/schemas/EducationalOccupationalCredentialSubEntity"}]},"experience_requirements":{"description":"Required experience","nullable":true,"allOf":[{"$ref":"#/components/schemas/OccupationalExperienceRequirementsSubEntity"}]},"experience_in_place_of_education":{"type":"boolean","description":"Experience accepted in lieu of degree?","nullable":true},"responsibilities":{"description":"Job responsibilities / tasks","type":"array","items":{"type":"string"}},"skills":{"description":"Sought-after skills","type":"array","items":{"$ref":"#/components/schemas/SkillSubEntity"}},"physical_requirement":{"type":"string","description":"Physical requirements","nullable":true},"sensory_requirement":{"type":"string","description":"Sensory requirements","nullable":true},"security_clearance_requirement":{"type":"string","description":"Security clearances","nullable":true},"eligibility_to_work_requirement":{"type":"string","description":"Legal work conditions (visa, ...)","nullable":true},"employer_overview":{"type":"string","description":"Employer presentation","nullable":true},"special_commitments":{"type":"string","description":"Special commitments (VeteranCommit, ...)","nullable":true},"application_contact":{"description":"Contact point for the application","nullable":true,"allOf":[{"$ref":"#/components/schemas/ContactPointSubEntity"}]},"direct_apply":{"type":"boolean","description":"Does the posting allow direct application?","nullable":true},"relevant_occupation":{"type":"string","description":"Related occupation (free text)","nullable":true},"url":{"type":"string","description":"Canonical URL of the posting","nullable":true},"same_as":{"type":"string","description":"Reference URL for identity","nullable":true},"image":{"type":"string","description":"Image URL","nullable":true}},"required":["title","description","identifier","date_posted","valid_through","hiring_organization","employment_unit","job_location","job_location_type","applicant_location_requirements","employment_type","work_hours","job_immediate_start","job_start_date","total_job_openings","base_salary","estimated_salary","salary_currency","incentive_compensation","job_benefits","industry","occupational_category","qualifications","education_requirements","experience_requirements","experience_in_place_of_education","physical_requirement","sensory_requirement","security_clearance_requirement","eligibility_to_work_requirement","employer_overview","special_commitments","application_contact","direct_apply","relevant_occupation","url","same_as","image"]},"PatchJobPostingDto":{"type":"object","properties":{"title":{"type":"string","description":"Job title"},"description":{"type":"string","description":"Job description","nullable":true},"alternate_name":{"description":"Alternative job titles","type":"array","items":{"type":"string"}},"identifier":{"type":"string","description":"Unique identifier (slug, UUID, ...)","nullable":true},"date_posted":{"format":"date-time","type":"string","description":"Publication date","nullable":true},"valid_through":{"format":"date-time","type":"string","description":"Posting expiration date","nullable":true},"hiring_organization":{"description":"Recruiting company","nullable":true,"allOf":[{"$ref":"#/components/schemas/OrganizationSubEntity"}]},"employment_unit":{"description":"Department / unit concerned","nullable":true,"allOf":[{"$ref":"#/components/schemas/OrganizationSubEntity"}]},"job_location":{"description":"Workplace","nullable":true,"allOf":[{"$ref":"#/components/schemas/PlaceSubEntity"}]},"job_location_type":{"type":"string","description":"Remote/work arrangement type, e.g. TELECOMMUTE","nullable":true},"applicant_location_requirements":{"type":"string","description":"Allowed geographic areas (remote work)","nullable":true},"employment_type":{"type":"string","description":"Contract type (full-time, part-time, ...)","nullable":true},"work_hours":{"type":"string","description":"Typical hours","nullable":true},"job_immediate_start":{"type":"boolean","description":"Immediate start?","nullable":true},"job_start_date":{"format":"date-time","type":"string","description":"Expected start date","nullable":true},"total_job_openings":{"type":"number","description":"Number of open positions","nullable":true},"base_salary":{"description":"Base salary","nullable":true,"allOf":[{"$ref":"#/components/schemas/MonetaryAmountSubEntity"}]},"estimated_salary":{"description":"Estimated salary","nullable":true,"allOf":[{"$ref":"#/components/schemas/MonetaryAmountSubEntity"}]},"salary_currency":{"type":"string","description":"Main currency (ISO 4217)","nullable":true},"incentive_compensation":{"type":"string","description":"Bonuses / commissions","nullable":true},"job_benefits":{"type":"string","description":"Benefits","nullable":true},"industry":{"type":"string","description":"Industry sector","nullable":true},"occupational_category":{"type":"string","description":"Occupational category (O*NET, ISCO, ...)","nullable":true},"qualifications":{"description":"Required diploma / certification / qualifications","nullable":true,"allOf":[{"$ref":"#/components/schemas/EducationalOccupationalCredentialSubEntity"}]},"education_requirements":{"description":"Required education level","nullable":true,"allOf":[{"$ref":"#/components/schemas/EducationalOccupationalCredentialSubEntity"}]},"experience_requirements":{"description":"Required experience","nullable":true,"allOf":[{"$ref":"#/components/schemas/OccupationalExperienceRequirementsSubEntity"}]},"experience_in_place_of_education":{"type":"boolean","description":"Experience accepted in lieu of degree?","nullable":true},"responsibilities":{"description":"Job responsibilities / tasks","type":"array","items":{"type":"string"}},"skills":{"description":"Sought-after skills","type":"array","items":{"$ref":"#/components/schemas/SkillSubEntity"}},"physical_requirement":{"type":"string","description":"Physical requirements","nullable":true},"sensory_requirement":{"type":"string","description":"Sensory requirements","nullable":true},"security_clearance_requirement":{"type":"string","description":"Security clearances","nullable":true},"eligibility_to_work_requirement":{"type":"string","description":"Legal work conditions (visa, ...)","nullable":true},"employer_overview":{"type":"string","description":"Employer presentation","nullable":true},"special_commitments":{"type":"string","description":"Special commitments (VeteranCommit, ...)","nullable":true},"application_contact":{"description":"Contact point for the application","nullable":true,"allOf":[{"$ref":"#/components/schemas/ContactPointSubEntity"}]},"direct_apply":{"type":"boolean","description":"Does the posting allow direct application?","nullable":true},"relevant_occupation":{"type":"string","description":"Related occupation (free text)","nullable":true},"url":{"type":"string","description":"Canonical URL of the posting","nullable":true},"same_as":{"type":"string","description":"Reference URL for identity","nullable":true},"image":{"type":"string","description":"Image URL","nullable":true}}},"OrganisationJobPostingEntity":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"507f1f77bcf86cd799439011"},"created_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"updated_at":{"format":"date-time","type":"string","readOnly":true,"example":"2026-06-15T08:27:53.993Z"},"organisation":{"type":"string","example":"/organisations/507f1f77bcf86cd799439011"},"jobPosting":{"type":"string","example":"/organisations/507f1f77bcf86cd799439011/jobPostings/507f1f77bcf86cd799439012"},"career":{"type":"string","nullable":true,"example":"/organisations/507f1f77bcf86cd799439011/careers/507f1f77bcf86cd799439013"},"status":{"type":"string","enum":["DRAFT","OPEN","CLOSED"]}},"required":["id","created_at","updated_at","organisation","jobPosting","career","status"]},"PutOrganisationJobPostingDto":{"type":"object","properties":{"career_id":{"type":"string","nullable":true},"status":{"type":"string","enum":["DRAFT","OPEN","CLOSED"]}},"required":["career_id","status"]},"PatchOrganisationJobPostingDto":{"type":"object","properties":{"career_id":{"type":"string","nullable":true},"status":{"type":"string","enum":["DRAFT","OPEN","CLOSED"]}}},"HydraView":{"type":"object","properties":{"@context":{"type":"string"},"@id":{"type":"string"},"@type":{"type":"string"},"hydra:first":{"type":"string"},"hydra:last":{"type":"string"},"hydra:previous":{"type":"string"},"hydra:next":{"type":"string"}},"required":["@context","@id","@type","hydra:first","hydra:last","hydra:previous","hydra:next"]},"HydraSearch":{"type":"object","properties":{"@context":{"type":"string"},"@id":{"type":"string"},"@type":{"type":"string"},"hydra:template":{"type":"string"},"hydra:variableRepresentation":{"type":"string"},"hydra:mapping":{"type":"array","items":{"type":"string"}}},"required":["@context","@id","@type","hydra:template","hydra:variableRepresentation","hydra:mapping"]},"HydraPaginator":{"type":"object","properties":{"@context":{"type":"string"},"@id":{"type":"string"},"@type":{"type":"string"},"hydra:member":{"type":"array","items":{"type":"object"}},"hydra:totalItems":{"type":"number"},"hydra:view":{"$ref":"#/components/schemas/HydraView"},"hydra:search":{"$ref":"#/components/schemas/HydraSearch"}},"required":["@context","@id","@type","hydra:member","hydra:totalItems","hydra:view","hydra:search"]},"HydraError":{"type":"object","properties":{"@context":{"type":"string"},"@type":{"type":"string"},"hydra:title":{"type":"string","description":"The title of the error"},"hydra:description":{"type":"string","description":"The detail of the error"},"hydra:statusCode":{"type":"number","description":"The status code of the error"}},"required":["@context","@type","hydra:title","hydra:description","hydra:statusCode"]}}}}