# Share an artifact generated by the agent

Copies a file artifact generated by the agent to a shared location.
    
    This endpoint:
    1. Retrieves the session state using the provided session ID
    2. Gets the specified message by its index in the messages array
    3. Retrieves the generated_artifacts field from the message response_metadata
    4. Copies the file at the specified artifact index to /tmp/share
    
    Returns the path to the copied file or an error if the file cannot be found/copied.

Endpoint: POST /core/v1/share_agent_artifact
Version: v1
Security: APIKeyHeader

## Query parameters:

  - `message_index` (integer, required)

  - `artifact_index` (integer, required)

## Header parameters:

  - `session-id` (string, required)
    Session unique identifier for which to share an artifact

  - `user-name` (string, required)
    User name for the request

## Response 400 fields (application/json):

  - `body` (string, required)
    Error message or description

  - `status_code` (integer, required)
    HTTP status code
    Example: 400

  - `details` (any)
    Additional error details if available

## Response 404 fields (application/json):

  - `body` (string, required)
    Error message or description

  - `status_code` (integer, required)
    HTTP status code
    Example: 400

  - `details` (any)
    Additional error details if available

## Response 422 fields (application/json):

  - `body` (string, required)
    Error message or description

  - `status_code` (integer, required)
    HTTP status code
    Example: 400

  - `details` (any)
    Additional error details if available

## Response 500 fields (application/json):

  - `body` (string, required)
    Error message or description

  - `status_code` (integer, required)
    HTTP status code
    Example: 400

  - `details` (any)
    Additional error details if available