{"files":{"SKILL.md":"---\nname: benefits-intake\ndescription: \"Benefits Intake API skill. Use when working with Benefits Intake for uploads, path. Covers 6 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Benefits Intake\nAPI version: 1.0.0\n\n## Auth\nApiKey apikey in header\n\n## Base URL\nhttps://sandbox-api.va.gov/services/vba_documents/v1\n\n## Setup\n1. Set your API key in the appropriate header\n2. GET /uploads/{id} -- get status for a previous benefits document upload\n3. POST /uploads -- create first upload\n\n## Endpoints\n6 endpoints across 2 groups. See references/api-spec.lap for full details.\n\n### Uploads\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /uploads | Get a location for subsequent document upload PUT request |\n| GET | /uploads/{id} | Get status for a previous benefits document upload |\n| GET | /uploads/{id}/download | Download zip of \"what the server sees\" |\n| POST | /uploads/report | Get a bulk status report for a list of previous uploads |\n| POST | /uploads/validate_document | Validate an individual document against system file requirements |\n\n### Path\n| Method | Path | Description |\n|--------|------|-------------|\n| PUT | /path | Accepts document upload. |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"Create a upload?\" -> POST /uploads\n- \"Get upload details?\" -> GET /uploads/{id}\n- \"List all download?\" -> GET /uploads/{id}/download\n- \"Create a report?\" -> POST /uploads/report\n- \"Create a validate_document?\" -> POST /uploads/validate_document\n- \"How to authenticate?\" -> See Auth section above\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Create/update endpoints return the modified resource on success\n- Error responses include status codes and descriptions in the spec\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api Benefits Intake\n@base https://sandbox-api.va.gov/services/vba_documents/v1\n@version 1.0.0\n@auth ApiKey apikey in header\n@endpoints 6\n@toc uploads(5), path(1)\n\n@group uploads\n@endpoint POST /uploads\n@desc Get a location for subsequent document upload PUT request\n@returns(202) {data: any} # Accepted. Location generated\n@errors {401: Unauthorized request, 403: Forbidden, 422: Unprocessable Entity, 429: Too many requests, 500: Internal server error}\n\n@endgroup\n\n@group path\n@endpoint PUT /path\n@desc Accepts document upload.\n@optional {Content-MD5: str(md5) # Base64-encoded 128-bit MD5 digest of the message. Use for integrity control}\n@returns(200) Document upload staged\n@errors {401: Unauthorized request, 403: Document upload failed, 422: Unprocessable Entity, 429: Too many requests, 500: Internal server error}\n\n@endgroup\n\n@group uploads\n@endpoint GET /uploads/{id}\n@desc Get status for a previous benefits document upload\n@required {id: str(uuid) # ID as returned by a previous create upload request}\n@returns(200) {data: any} # Upload status retrieved successfully\n@errors {401: Unauthorized request, 403: Forbidden, 404: Not found, 429: Too many requests, 500: Internal server error}\n\n@endpoint GET /uploads/{id}/download\n@desc Download zip of \"what the server sees\"\n@required {id: str(uuid) # ID as returned by a previous create upload request}\n@returns(200) Zip file with the contents of your payload as parsed by our server\n@errors {401: Unauthorized request, 403: Forbidden, 404: Not found, 429: Too many requests, 500: Internal server error}\n\n@endpoint POST /uploads/report\n@desc Get a bulk status report for a list of previous uploads\n@required {ids: [str(uuid)] # List of IDs for previous document upload submissions (max 1000)}\n@returns(200) {data: [any]} # Upload status report retrieved successfully\n@errors {400: Bad Request - invalid, missing, or oversized list of guids (max 1000), 401: Unauthorized request, 403: Forbidden, 422: Unprocessable Entity, 429: Too many requests, 500: Internal server error}\n\n@endpoint POST /uploads/validate_document\n@desc Validate an individual document against system file requirements\n@returns(200) {data: any} # Document passed system requirements\n@errors {401: Unauthorized request, 403: Forbidden, 422: Document did NOT pass system requirements, 429: Too many requests, 500: Internal server error}\n\n@endgroup\n\n@end\n"}}