---
title: "POST /AddArtifact"
method: POST
path: "/AddArtifact"
---

# POST /AddArtifact

`POST /AddArtifact`

Uploads an artifact to an agent space. Artifacts provide additional context for security testing, such as architecture diagrams, API specifications, or configuration files.

## Request body

- object
  - `agentSpaceId` string, required — Unique identifier of the agent space.
  - `artifactContent` string, required — The binary content of the artifact to upload.
  - `artifactType` 'TXT' | 'PNG' | 'JPEG' | 'MD' | 'PDF' | 'DOCX' | 'DOC' | 'JSON' | 'YAML', required — Supported file extension types for artifacts.
  - `fileName` string, required — The file name of the artifact.

## Response `201`

Success

- AddArtifactOutput
  - `artifactId` string, required — The unique identifier assigned to the uploaded artifact.

## Other responses

- `480` — ValidationException
- `481` — InternalServerException
- `482` — ResourceNotFoundException
- `483` — ThrottlingException
- `484` — AccessDeniedException

---

[API](https://skmtc.net/aws/apis/securityagent.md) · [All operations](https://skmtc.net/aws/apis/securityagent/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/securityagent/versions/cad56717d636/schema)