# remote-api-forms

> Claude/Codex skill by [@remoteoss](https://omgskills.com/library/remoteoss/index.md) · 1 stars · Updated 2026-07-09

Build and validate request bodies for Remote.com's dynamic JSON-Schema form endpoints - the schema-first mechanism behind most REST writes. Use when fetching a form schema (GET /v1/countries/{country\_code}/{form}, /v1/companies/schema, /v1/contract-amendments/schema, and similar), honoring required/enum/oneOf/if-then-else, handling conditionally-forbidden fields or x-jsf-\* presentation/currency, or 422 validation on any form-driven write - company creation, personal-details, contract amendments, terminations, contractor onboarding, legal-entity details, benefits. For the multi-form hire sequence use remote-api-onboarding. Do NOT use to operate via the MCP, for auth (remote-api-auth), endpoint discovery (remote-api-integration), or webhooks (remote-api-webhooks).

## Install

```sh
git clone https://github.com/remoteoss/remote-for-ai /tmp/remote-for-ai && ln -s /tmp/remote-for-ai/skills/remote-api-forms ~/.claude/skills/remote-api-forms
```

## From README

Remote API Forms Build and submit request bodies for Remote.com's dynamic JSON-Schema form endpoints. Most Remote write operations do not accept a fixed field list — the required and optional fields are determined at runtime by a JSON Schema that varies by country, employment type, and regulatory context. This skill covers the full cycle: find the right schema endpoint, fetch the schema, build a conforming body, submit it, and handle 422 validation errors. Invoke This Skill When Creating or updating any resource that uses a country, company, or resource-specific form (employment, contractor, contract amendment, termination, company creation, personal details). Building or validating a request body for an onboarding, contract, company, personal-details, or termination write. Implementing a UI for Remote JSON Schema forms, including rendering fields, visibility, required state, conditionals, computed attributes, or client-side validation.

## Links

- HTML page: https://omgskills.com/library/remoteoss/remote-for-ai/skills/remote-api-forms/
- GitHub: https://github.com/remoteoss/remote-for-ai
- Author: [@remoteoss](https://omgskills.com/library/remoteoss/index.md)

## More from this repo

- [remote-api-auth](https://omgskills.com/library/remoteoss/remote-for-ai/skills/remote-api-auth/index.md) — Authenticate to the Remote.com REST API and obtain access tokens for an integration.
   - [@remoteoss](https://omgskills.com/library/remoteoss/index.md) · 1 stars
- [remote-api-integration](https://omgskills.com/library/remoteoss/remote-for-ai/skills/remote-api-integration/index.md) — Used to build integrations that call the Remote.com REST API (developer.remote.com) - global HR/payroll/EOR.
   - [@remoteoss](https://omgskills.com/library/remoteoss/index.md) · 1 stars
- [remote-api-webhooks](https://omgskills.com/library/remoteoss/remote-for-ai/skills/remote-api-webhooks/index.md) — Receive and verify Remote.com webhooks in an integration.
   - [@remoteoss](https://omgskills.com/library/remoteoss/index.md) · 1 stars