hires_upload_attachment
Upload a file and create an attachment. Supported categories: voicemail (wav/mp3, max 20 MB, no object_id — returned uuid is usable as attachment_uuid in nurture voicemail steps); candidate (candidate ID); application (application ID); candidate_comment (comment ID); job_note (job-note ID); compa...
This record as markdown: /tools/com-100hires-100hires/hires-upload-attachment.md
What hires_upload_attachment does on 100Hires - AI ATS & Recruitment Software
AI agents use hires_upload_attachment to create or update resources in 100Hires - AI ATS & Recruitment Software, usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your 100Hires - AI ATS & Recruitment Software environment.
| Parameter | Type | Required | Description |
|---|---|---|---|
file | object | Yes | File payload. |
category | string | Yes | Attachment category. Determines allowed extensions and object_id semantics. |
object_id | number | null | — | Target object ID (candidate/application/comment/job-note/company, per category). Omit for `voicemail`. |
company_id | number | null | — | Target company ID. Needed for partner API keys managing multiple client companies. Omitted → defaults to the authenticated company. The object_id must belong to |
Parameters from the server's own tool schema.
Why hires_upload_attachment is rated Medium
This tool creates new attachment records in the system, which is a reversible data modification operation. It does not execute code, delete data, or move money. The 'medium' severity reflects that file uploads could potentially be abused to store malicious content or exhaust storage quotas, but the strict object ownership verification and file type/size constraints (max 20 MB for audio) mitigate risk.
From the tool's definition Tool description states 'Upload a file and create an attachment' with support for multiple object types (candidate, application, comment, job note, company assets). Returns uuid, url, file, and relative_time indicating persistent creation of new resources.
Risk signalsAccepts file system path (file)
Attacks that exploit this kind of access
The rule that runs hires_upload_attachment safely
PolicyLayer is an MCP gateway: it sits between your AI agents and 100Hires - AI ATS & Recruitment Software, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For hires_upload_attachment, this is the rule to start with:
hires_upload_attachment stays usable, but capped: an agent stuck in a loop can't make hundreds of changes a minute. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect 100Hires - AI ATS & Recruitment Software, apply this rule, and every hires_upload_attachment call is checked against it from then on.
Questions about hires_upload_attachment
Upload a file and create an attachment. Supported categories: voicemail (wav/mp3, max 20 MB, no object_id — returned uuid is usable as attachment_uuid in nurture voicemail steps); candidate (candidate ID); application (application ID); candidate_comment (comment ID); job_note (job-note ID); company_favicon/company_header/company_link_preview (company ID). Object ownership is strictly verified against the authenticated API key's company. Returns {uuid, url, file, relative_time}. It is categorised as a Write tool in the 100Hires - AI ATS & Recruitment Software MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.
hires_upload_attachment accepts 4 parameters: file, category, object_id, company_id. Required: file, category. The full parameter table on this page comes from the server's own tool schema.
Register the 100Hires - AI ATS & Recruitment Software MCP server in PolicyLayer and add a rule for hires_upload_attachment: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches 100Hires - AI ATS & Recruitment Software. Nothing to install.
hires_upload_attachment is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.
Yes. Add a rate_limit block to the hires_upload_attachment rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for hires_upload_attachment. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
hires_upload_attachment is provided by the 100Hires - AI ATS & Recruitment Software MCP server (https://mcp.100hires.com/mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on 100Hires - AI ATS & Recruitment Software, and thousands of servers like it.
Across the catalogue