@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Benefits Intake
@base https://sandbox-api.va.gov/services/vba_documents/v1
@version 1.0.0
@auth ApiKey apikey in header
@endpoints 6
@toc uploads(5), path(1)

@group uploads
@endpoint POST /uploads
@returns(202) {data: any}
@errors {401, 403, 422, 429, 500}

@endgroup

@group path
@endpoint PUT /path
@optional {Content-MD5: str(md5)}
@returns(200)
@errors {401, 403, 422, 429, 500}

@endgroup

@group uploads
@endpoint GET /uploads/{id}
@required {id: str(uuid)}
@returns(200) {data: any}
@errors {401, 403, 404, 429, 500}

@endpoint GET /uploads/{id}/download
@required {id: str(uuid)}
@returns(200)
@errors {401, 403, 404, 429, 500}

@endpoint POST /uploads/report
@required {ids: [str(uuid)]}
@returns(200) {data: [any]}
@errors {400, 401, 403, 422, 429, 500}

@endpoint POST /uploads/validate_document
@returns(200) {data: any}
@errors {401, 403, 422, 429, 500}

@endgroup

@end