> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentarea.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Task Artifacts

> List files the agent explicitly published as durable artifacts.

Workspace-scoped: the task must belong to the caller's workspace, or we
return 404. Each item carries an AgentArea API download URL, so access
stays behind our auth, audit, and workspace checks instead of exposing
object-storage URLs directly.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/agents/{agent_id}/tasks/{task_id}/artifacts
openapi: 3.1.0
info:
  description: >-
    Modular and extensible framework for building AI agents. This API requires
    JWT Bearer token authentication for most endpoints. Include your JWT token
    in the Authorization header. Public endpoints include /, /health, /docs,
    /redoc, and /openapi.json.
  title: AgentArea API
  version: 0.1.0
servers: []
security:
  - bearer: []
paths:
  /v1/agents/{agent_id}/tasks/{task_id}/artifacts:
    get:
      tags:
        - v1
        - protected
        - agent-tasks
      summary: List Task Artifacts
      description: |-
        List files the agent explicitly published as durable artifacts.

        Workspace-scoped: the task must belong to the caller's workspace, or we
        return 404. Each item carries an AgentArea API download URL, so access
        stays behind our auth, audit, and workspace checks instead of exposing
        object-storage URLs directly.
      operationId: list_task_artifacts_v1_agents__agent_id__tasks__task_id__artifacts_get
      parameters:
        - in: path
          name: agent_id
          required: true
          schema:
            format: uuid
            title: Agent Id
            type: string
        - in: path
          name: task_id
          required: true
          schema:
            format: uuid
            title: Task Id
            type: string
        - in: query
          name: expires_in
          required: false
          schema:
            default: 3600
            maximum: 86400
            minimum: 60
            title: Expires In
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/TaskArtifactItem'
                title: >-
                  Response List Task Artifacts V1 Agents  Agent Id  Tasks  Task
                  Id  Artifacts Get
                type: array
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
        - HTTPBearer: []
components:
  schemas:
    TaskArtifactItem:
      description: A file explicitly published from a live task sandbox.
      properties:
        content_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Content Type
        created_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          title: Created At
        download_url:
          title: Download Url
          type: string
        id:
          title: Id
          type: string
        name:
          title: Name
          type: string
        path:
          title: Path
          type: string
        sha256:
          anyOf:
            - type: string
            - type: 'null'
          title: Sha256
        size:
          title: Size
          type: integer
      required:
        - id
        - path
        - name
        - size
        - content_type
        - sha256
        - created_at
        - download_url
      title: TaskArtifactItem
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    ValidationError:
      properties:
        ctx:
          title: Context
          type: object
        input:
          title: Input
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
  securitySchemes:
    bearer:
      bearerFormat: JWT
      description: JWT Bearer token for authentication
      scheme: bearer
      type: http
    HTTPBearer:
      scheme: bearer
      type: http

````