> ## Documentation Index > Fetch the complete documentation index at: https://docs.forestreet.com/llms.txt > Use this file to discover all available pages before exploring further. # Create a dossier > Create a new dossier in the specified collection using AI to generate supplier information ## OpenAPI ````yaml post /v2/collections/{collectionId}/dossier/create openapi: 3.0.0 info: title: Forestreet API version: 1.0.0 description: API documentation for Forestreet API servers: - url: https://rest.forestreet.com description: Forestreet API V2 server security: - apiKeyAuth: [] - bearerAuth: [] - sessionIdQuery: [] tags: [] paths: /v2/collections/{collectionId}/dossier/create: post: tags: - Dossier summary: Create a dossier description: >- Create a new dossier in the specified collection using AI to generate supplier information parameters: - schema: type: number nullable: true description: The collection ID to which the new dossier belongs. required: false description: The collection ID to which the new dossier belongs. name: collectionId in: path - schema: type: integer minimum: 1 description: >- Unique identifier of the team from which a quota should be consumed. required: true description: Unique identifier of the team from which a quota should be consumed. name: teamId in: query requestBody: content: application/json: schema: type: object properties: agentId: type: string description: The agent ID for the dossier. query: type: string description: The query to create the dossier. shouldUpdate: type: boolean default: false description: >- Whether the dossier should be updated if it already exists. Default is false. cacheOnly: type: boolean default: false description: >- Whether to only return cached results without querying the agent. Default is false. ignoreCache: type: boolean default: false description: >- Whether to ignore cached data when creating the dossier and always query the agent. Default is false. required: - query responses: '200': description: Dossier created successfully content: application/json: schema: type: object properties: agentId: type: string description: Unique identifier for the created dossier agent taskId: type: string format: uuid description: ID of the task associated with the created dossier agent required: - agentId - taskId '400': description: Bad Request - Invalid input parameters content: application/json: schema: type: object properties: success: type: boolean enum: - false errorCode: type: string enum: - USER_NOT_CONFIRMED - INVALID_CREDENTIALS - INCOMPLETE_CREDENTIALS - INVALID_SESSION_TOKEN - FORCE_CHANGE_PASSWORD - PASSWORD_RESET_REQUIRED - PASSWORD_EXPIRED - CODE_EXPIRED - SESSION_EXPIRED - UNAUTHORISED - AUTHENTICATOR_ERROR - SSO_ACCOUNT - FORBIDDEN - METHOD_NOT_ALLOWED - INVALID_INPUT - PATH_VALIDATION_FAILED - QUERY_VALIDATION_FAILED - BODY_VALIDATION_FAILED - RESPONSE_VALIDATION_FAILED - INVALID_OR_MALFORMED_JSON - INTERNAL_SERVER_ERROR - CONFIGURATION_ERROR - SERVICE_UNAVAILABLE - NOT_FOUND - CONFLICT - LIMIT_EXCEEDED - REVIEW_ALREADY_PENDING - REVIEW_NOT_PENDING - REVIEW_PENDING - REVIEW_INSUFFICIENT_DOMAINS - QUOTA_EXCEEDED - UNSUPPORTED_ENDPOINT_VERSION - ENDPOINT_NOT_FOUND - ENDPOINT_ALREADY_EXISTS message: type: string detail: type: object additionalProperties: nullable: true required: - success - errorCode examples: INVALID_INPUT: value: success: false errorCode: INVALID_INPUT message: Bad Request - Invalid input parameters '403': description: >- Forbidden - You do not have permission to create a dossier in this collection content: application/json: schema: type: object properties: success: type: boolean enum: - false errorCode: type: string enum: - USER_NOT_CONFIRMED - INVALID_CREDENTIALS - INCOMPLETE_CREDENTIALS - INVALID_SESSION_TOKEN - FORCE_CHANGE_PASSWORD - PASSWORD_RESET_REQUIRED - PASSWORD_EXPIRED - CODE_EXPIRED - SESSION_EXPIRED - UNAUTHORISED - AUTHENTICATOR_ERROR - SSO_ACCOUNT - FORBIDDEN - METHOD_NOT_ALLOWED - INVALID_INPUT - PATH_VALIDATION_FAILED - QUERY_VALIDATION_FAILED - BODY_VALIDATION_FAILED - RESPONSE_VALIDATION_FAILED - INVALID_OR_MALFORMED_JSON - INTERNAL_SERVER_ERROR - CONFIGURATION_ERROR - SERVICE_UNAVAILABLE - NOT_FOUND - CONFLICT - LIMIT_EXCEEDED - REVIEW_ALREADY_PENDING - REVIEW_NOT_PENDING - REVIEW_PENDING - REVIEW_INSUFFICIENT_DOMAINS - QUOTA_EXCEEDED - UNSUPPORTED_ENDPOINT_VERSION - ENDPOINT_NOT_FOUND - ENDPOINT_ALREADY_EXISTS message: type: string detail: type: object additionalProperties: nullable: true required: - success - errorCode examples: FORBIDDEN: value: success: false errorCode: FORBIDDEN message: >- Forbidden - You do not have permission to create a dossier in this collection '500': description: Internal Server Error - Failed to create dossier content: application/json: schema: type: object properties: success: type: boolean enum: - false errorCode: type: string enum: - USER_NOT_CONFIRMED - INVALID_CREDENTIALS - INCOMPLETE_CREDENTIALS - INVALID_SESSION_TOKEN - FORCE_CHANGE_PASSWORD - PASSWORD_RESET_REQUIRED - PASSWORD_EXPIRED - CODE_EXPIRED - SESSION_EXPIRED - UNAUTHORISED - AUTHENTICATOR_ERROR - SSO_ACCOUNT - FORBIDDEN - METHOD_NOT_ALLOWED - INVALID_INPUT - PATH_VALIDATION_FAILED - QUERY_VALIDATION_FAILED - BODY_VALIDATION_FAILED - RESPONSE_VALIDATION_FAILED - INVALID_OR_MALFORMED_JSON - INTERNAL_SERVER_ERROR - CONFIGURATION_ERROR - SERVICE_UNAVAILABLE - NOT_FOUND - CONFLICT - LIMIT_EXCEEDED - REVIEW_ALREADY_PENDING - REVIEW_NOT_PENDING - REVIEW_PENDING - REVIEW_INSUFFICIENT_DOMAINS - QUOTA_EXCEEDED - UNSUPPORTED_ENDPOINT_VERSION - ENDPOINT_NOT_FOUND - ENDPOINT_ALREADY_EXISTS message: type: string detail: type: object additionalProperties: nullable: true required: - success - errorCode examples: INTERNAL_SERVER_ERROR: value: success: false errorCode: INTERNAL_SERVER_ERROR message: Internal Server Error - Failed to create dossier components: securitySchemes: apiKeyAuth: type: apiKey in: header name: x-api-key description: >- Pass a static API key for every request, provided by your customer support. bearerAuth: type: http scheme: bearer description: >- Bearer token authentication, using a sessionId generated by `GET /v2/auth/session`. sessionIdQuery: type: apiKey in: query name: sessionId description: >- Session ID passed as a query parameter for authentication, provided by `GET /v2/auth/session`. ````