Overview
Humanos is an API designed to bring human authorization into automated workflows. It enables digital systems - APIs, workflows, and autonomous agents - to verify in real time whether a human has approved an action. If an authorization is missing, Humanos can immediately request it through a secure, unified flow, ensuring that processes never stall due to compliance checks or pending approvals. By turning human decisions into programmable, verifiable events, Humanos allows organizations to automate more confidently, reduce operational friction, and maintain full traceability of every authorization involved in a business process.Get Started
Create your account and start building with Humanos. Set up your API keys,
configure webhooks, and begin integrating human authorization into your
automated workflows.
API Reference
Browse the complete API reference to see how DIDs and VCs are used in practice
when working with the Humanos API.
Authentication
Learn how to authenticate with the API and understand the security mechanisms that protect your integrations.
W3C DIDs and VCs
Every entity in the Humanos ecosystem - automated systems, organizations, and end users - is identified using a Decentralized Identifier (DID) compliant with the W3C DID standard. This ensures globally unique, verifiable identities without relying on centralized identity providers. All authorizations collected through Humanos are encapsulated as W3C Verifiable Credentials (VC) 2.0. This gives each authorization a cryptographic proof, a tamper-evident structure, and a complete audit trail. As a result, every action performed on the platform - whether a signature, consent, mandate approval, or identity verification - is securely verifiable and traceable end-to-end.Learn about DIDs
Understand how Decentralized Identifiers work and how they enable globally unique, verifiable identities in the Humanos ecosystem.
Learn about VCs
Explore W3C Verifiable Credentials and how they provide cryptographic proof
and tamper-evident structures for all authorizations.
VIA Protocol
VIA (Verifiable Intent Authorization) is an open-source protocol that extends W3C Verifiable Credentials to enable authorization in the agentic era. As AI agents become capable of executing complex tasks - paying bills, booking travel, managing affairs - VIA ensures that every action is backed by cryptographic proof of genuine human intent. VIA introduces three core building blocks:- Mandates: Standing policies that define what an agent is allowed to do, under which conditions, and for how long. Revocable at any time by the human.
- PoAI (Proof of Authorized Intent): Signed proof of every decision - whether approved, denied, blocked, expired, or out of scope. Verifiable by anyone, forever.
- Humanos Intelligence: An adaptive layer that auto-approves routine actions within mandate scope and escalates anomalies to the human.
VIA Protocol
Explore the open-source VIA protocol on GitHub and learn how it enables verifiable human authorization for AI agents.
Authorization Flow
Learn how mandates, PoAIs, and the Humanos API work together to create auditable authorization flows.
Requests
A request is composed of a collection of authorizations that can be sent to one or multiple users through a secure link, which can be shared over any channel. Each authorization represents a specific human action your automated system needs in order to continue its workflow. Humanos supports several types of authorizations, including:- Identity Validations (KYC): Verify a user’s identity using a government-issued ID scan combined with a selfie.
- Signature Requests: Present PDFs for users to review, sign, or reject.
- Consents: Collect required or optional consents, with support for embedded external resources.
- Form Filling: Build and manage structured forms for users to complete.
- Mandates: A flexible, JSON-based authorization format that allows automated systems to request and collect arbitrary approvals from humans, enabling highly customizable decision flows.