HHS (US Department of Health and Human Services)

HHS (US Department of Health and Human Services) User v1 - Internal Only API

The User v1 - Internal Only API from HHS (US Department of Health and Human Services) — 23 operation(s) for user v1 - internal only.

GitHub OpenAPI

Operations 26

GET /v1/users/login User Login
POST /v1/users/token/logout User Token Logout
POST /v1/users/token/refresh User Token Refresh
GET /v1/users/{user_id} User Get
PUT /v1/users/{user_id}/profile Update the authenticated user's profile data'
POST /v1/users/{user_id}/agencies User Get Agencies
POST /v1/users/{user_id}/api-keys Create a new API key for the authenticated user
POST /v1/users/{user_id}/privileges Get the roles and privileges for the authenticated user
POST /v1/users/{user_id}/can_access Check user access for a given resource
POST /v1/users/{user_id}/applications Get all applications for a user
GET /v1/users/{user_id}/organizations User Get Organizations
POST /v1/users/{user_id}/api-keys/list List all API keys for the authenticated user
POST /v1/users/{user_id}/saved-searches User Save Search
POST /v1/users/{user_id}/invitations/list Get all invitations for a user by matching their login.gov email
POST /v1/users/{user_id}/saved-opportunities User Save Opportunity
POST /v1/users/{user_id}/saved-searches/list User Get Saved Searches
POST /v1/users/{user_id}/saved-opportunities/list User Get Saved Opportunities
PUT /v1/users/{user_id}/api-keys/{api_key_id} Rename an existing API key for the authenticated user
DELETE /v1/users/{user_id}/api-keys/{api_key_id} Delete (deactivate) an API key for the authenticated user
GET /v1/users/{user_id}/saved-opportunities/notifications User Get Saved Opportunity Notifications
POST /v1/users/{user_id}/saved-opportunities/notifications User Saved Opportunities Notifications
PUT /v1/users/{user_id}/saved-searches/{saved_search_id} User Update Saved Search
DELETE /v1/users/{user_id}/saved-searches/{saved_search_id} User Delete Saved Search
DELETE /v1/users/{user_id}/saved-opportunities/{opportunity_id} User Delete Saved Opportunity
POST /v1/users/{user_id}/invitations/{invitation_id}/organizations User Response Org Invitation
DELETE /v1/users/{user_id}/saved-opportunities/{legacy_opportunity_id} User Delete Saved Opportunity Legacy

Documentation

📖
Documentation
https://simpler.grants.gov/developers
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/hhs/refs/heads/main/rate-limits/simpler-grants.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/hhs/refs/heads/main/openapi/hhs-user-v1-internal-only-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/hhs/refs/heads/main/json-schema/opportunityv1.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/hhs/refs/heads/main/json-schema/opportunitysearchresponsev1.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/hhs/refs/heads/main/json-schema/agencyv1.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/hhs/refs/heads/main/json-schema/errorresponse.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/hhs/refs/heads/main/json-schema/paginationinfo.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/hhs/refs/heads/main/json-schema/healthcheckresponse.json

Other Resources

🔗
OpenAPISpec
https://raw.githubusercontent.com/api-evangelist/hhs/refs/heads/main/openapi/_original/simpler-grants-gov.yml
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/hhs/refs/heads/main/examples/v1_opportunities_search_post_request.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/hhs/refs/heads/main/examples/v1_agencies_search_post_request.json
🔗
JSONLDContext
https://raw.githubusercontent.com/api-evangelist/hhs/refs/heads/main/json-ld/context.json
🔗
Plans
https://raw.githubusercontent.com/api-evangelist/hhs/refs/heads/main/plans/simpler-grants.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/hhs-user-v1-internal-only-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

hhs-user-v1-internal-only-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  description: '

    Back end API for simpler.grants.gov.


    This API is in active development as we build out new functionalities for Simpler.Grants.gov. It is currently stable for everyday use, and will be versioned with advance notice for any breaking changes.


    Learn more in our [API documentation](https://wiki.simpler.grants.gov/product/api).

    See [Release Phases](https://github.com/github/roadmap?tab=readme-ov-file#release-phases) for further details.

    '
  contact:
    name: Simpler Grants.gov
    url: https://simpler.grants.gov/
    email: simpler@grants.gov
  title: Simpler Grants User v1 - Internal Only API
  version: v0
servers: .
tags:
- name: User v1 - Internal Only
paths:
  /v1/users/login:
    get:
      parameters:
      - in: query
        name: piv_required
        description: Whether the user is required to use a PIV to login
        schema:
          type: boolean
          nullable: true
        required: false
      responses:
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Validation error
        '302':
          content:
            application/json:
              schema: {}
          description: Found
      tags:
      - User v1 - Internal Only
      summary: User Login
      description: '

        To use this endpoint, click [this link](/v1/users/login) which will redirect

        you to an OAuth provider where you can sign into an account.


        Do not try to use the execute option below as OpenAPI will not redirect your browser for you.


        The token you receive can then be set to the X-SGG-Token header for authenticating with endpoints.

        '
  /v1/users/token/logout:
    post:
      parameters: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserTokenLogoutResponseSchema'
          description: Successful response
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Authentication error
      tags:
      - User v1 - Internal Only
      summary: User Token Logout
      security:
      - ApiJwtAuth: []
  /v1/users/token/refresh:
    post:
      parameters: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserTokenRefreshResponseSchema'
          description: Successful response
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Authentication error
      tags:
      - User v1 - Internal Only
      summary: User Token Refresh
      security:
      - ApiJwtAuth: []
  /v1/users/{user_id}:
    get:
      parameters:
      - in: path
        name: user_id
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserGetResponseSchema'
          description: Successful response
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Authentication error
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Not found
      tags:
      - User v1 - Internal Only
      summary: User Get
      security:
      - ApiJwtAuth: []
  /v1/users/{user_id}/profile:
    put:
      parameters:
      - in: path
        name: user_id
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserUpdateProfileResponseSchema'
          description: Successful response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Validation error
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Authentication error
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Not found
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Forbidden
      tags:
      - User v1 - Internal Only
      summary: Update the authenticated user's profile data'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserUpdateProfileRequestSchema'
      security:
      - ApiJwtAuth: []
  /v1/users/{user_id}/agencies:
    post:
      parameters:
      - in: path
        name: user_id
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserAgenciesResponseSchema'
          description: Successful response
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Authentication error
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Not found
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Forbidden
      tags:
      - User v1 - Internal Only
      summary: User Get Agencies
      security:
      - ApiJwtAuth: []
      - ApiUserKeyAuth: []
  /v1/users/{user_id}/api-keys:
    post:
      parameters:
      - in: path
        name: user_id
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserApiKeyCreateResponseSchema'
          description: Successful response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Validation error
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Authentication error
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Not found
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Bad Request
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Forbidden
      tags:
      - User v1 - Internal Only
      summary: Create a new API key for the authenticated user
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserApiKeyCreateRequestSchema'
      security:
      - ApiJwtAuth: []
  /v1/users/{user_id}/privileges:
    post:
      parameters:
      - in: path
        name: user_id
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserGetRolesAndPrivilegesResponseSchema'
          description: Successful response
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Authentication error
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Not found
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Forbidden
      tags:
      - User v1 - Internal Only
      summary: Get the roles and privileges for the authenticated user
      security:
      - ApiJwtAuth: []
  /v1/users/{user_id}/can_access:
    post:
      parameters:
      - in: path
        name: user_id
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserCanAccessResponseSchema'
          description: Successful response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Validation error
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Authentication error
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Not found
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Forbidden
      tags:
      - User v1 - Internal Only
      summary: Check user access for a given resource
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserCanAccessRequestSchema'
      security:
      - ApiJwtAuth: []
  /v1/users/{user_id}/applications:
    post:
      parameters:
      - in: path
        name: user_id
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserApplicationListResponseSchema'
          description: Successful response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Validation error
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Authentication error
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Not found
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Forbidden
      tags:
      - User v1 - Internal Only
      summary: Get all applications for a user
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserApplicationListRequestSchema'
      security:
      - ApiJwtAuth: []
  /v1/users/{user_id}/organizations:
    get:
      parameters:
      - in: path
        name: user_id
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserOrganizationsResponseSchema'
          description: Successful response
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Authentication error
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Not found
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Forbidden
      tags:
      - User v1 - Internal Only
      summary: User Get Organizations
      security:
      - ApiJwtAuth: []
  /v1/users/{user_id}/api-keys/list:
    post:
      parameters:
      - in: path
        name: user_id
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserApiKeyListResponseSchema'
          description: Successful response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Validation error
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Authentication error
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Not found
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Forbidden
      tags:
      - User v1 - Internal Only
      summary: List all API keys for the authenticated user
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserApiKeyListRequestSchema'
      security:
      - ApiJwtAuth: []
  /v1/users/{user_id}/saved-searches:
    post:
      parameters:
      - in: path
        name: user_id
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserSaveSearchResponseSchema'
          description: Successful response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Validation error
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Authentication error
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Not found
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Forbidden
      tags:
      - User v1 - Internal Only
      summary: User Save Search
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserSaveSearchRequestSchema'
      security:
      - ApiJwtAuth: []
  /v1/users/{user_id}/invitations/list:
    post:
      parameters:
      - in: path
        name: user_id
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserInvitationListResponseSchema'
          description: Successful response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Validation error
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Authentication error
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Not found
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Forbidden
      tags:
      - User v1 - Internal Only
      summary: Get all invitations for a user by matching their login.gov email
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserInvitationListRequestSchema'
      security:
      - ApiJwtAuth: []
  /v1/users/{user_id}/saved-opportunities:
    post:
      parameters:
      - in: path
        name: user_id
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserSaveOpportunityResponseSchema'
          description: Successful response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Validation error
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Authentication error
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Not found
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Forbidden
      tags:
      - User v1 - Internal Only
      summary: User Save Opportunity
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserSaveOpportunityRequestSchema'
      security:
      - ApiJwtAuth: []
  /v1/users/{user_id}/saved-searches/list:
    post:
      parameters:
      - in: path
        name: user_id
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserSavedSearchesResponseSchema'
          description: Successful response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Validation error
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Authentication error
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Not found
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Forbidden
      tags:
      - User v1 - Internal Only
      summary: User Get Saved Searches
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserSavedSearchesRequestSchema'
      security:
      - ApiJwtAuth: []
  /v1/users/{user_id}/saved-opportunities/list:
    post:
      parameters:
      - in: path
        name: user_id
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserSavedOpportunitiesResponseSchema'
          description: Successful response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Validation error
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Authentication error
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Not found
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Forbidden
      tags:
      - User v1 - Internal Only
      summary: User Get Saved Opportunities
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserSavedOpportunitiesRequestSchema'
      security:
      - ApiJwtAuth: []
  /v1/users/{user_id}/api-keys/{api_key_id}:
    put:
      parameters:
      - in: path
        name: user_id
        schema:
          type: string
        required: true
      - in: path
        name: api_key_id
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserApiKeyRenameResponseSchema'
          description: Successful response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Validation error
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Authentication error
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Not found
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Bad Request
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Forbidden
      tags:
      - User v1 - Internal Only
      summary: Rename an existing API key for the authenticated user
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserApiKeyRenameRequestSchema'
      security:
      - ApiJwtAuth: []
    delete:
      parameters:
      - in: path
        name: user_id
        schema:
          type: string
        required: true
      - in: path
        name: api_key_id
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserApiKeyDeleteResponseSchema'
          description: Successful response
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Authentication error
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Not found
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Forbidden
      tags:
      - User v1 - Internal Only
      summary: Delete (deactivate) an API key for the authenticated user
      security:
      - ApiJwtAuth: []
  /v1/users/{user_id}/saved-opportunities/notifications:
    get:
      parameters:
      - in: path
        name: user_id
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserSavedOpportunityNotificationsResponseSchema'
          description: Successful response
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Authentication error
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Not found
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Forbidden
      tags:
      - User v1 - Internal Only
      summary: User Get Saved Opportunity Notifications
      security:
      - ApiJwtAuth: []
      - ApiUserKeyAuth: []
    post:
      parameters:
      - in: path
        name: user_id
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SetUserSavedOpportunityNotificationResponseSchema'
          description: Successful response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Validation error
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Authentication error
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Not found
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Forbidden
      tags:
      - User v1 - Internal Only
      summary: User Saved Opportunities Notifications
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SetUserSavedOpportunityNotificationRequestSchema'
      security:
      - ApiJwtAuth: []
      - ApiUserKeyAuth: []
  /v1/users/{user_id}/saved-searches/{saved_search_id}:
    put:
      parameters:
      - in: path
        name: user_id
        schema:
          type: string
        required: true
      - in: path
        name: saved_search_id
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserUpdateSavedSearchResponseSchema'
          description: Successful response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Validation error
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Authentication error
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Not found
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Forbidden
      tags:
      - User v1 - Internal Only
      summary: User Update Saved Search
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserUpdateSavedSearchRequestSchema'
      security:
      - ApiJwtAuth: []
    delete:
      parameters:
      - in: path
        name: user_id
        schema:
          type: string
        required: true
      - in: path
        name: saved_search_id
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserDeleteSavedSearchResponseSchema'
          description: Successful response
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Authentication error
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Not found
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Forbidden
      tags:
      - User v1 - Internal Only
      summary: User Delete Saved Search
      security:
      - ApiJwtAuth: []
  /v1/users/{user_id}/saved-opportunities/{opportunity_id}:
    delete:
      parameters:
      - in: path
        name: user_id
        schema:
          type: string
        required: true
      - in: path
        name: opportunity_id
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserDeleteSavedOpportunityResponseSchema'
          description: Successful response
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Authentication error
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Not found
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Forbidden
      tags:
      - User v1 - Internal Only
      summary: User Delete Saved Opportunity
      security:
      - ApiJwtAuth: []
  /v1/users/{user_id}/invitations/{invitation_id}/organizations:
    post:
      parameters:
      - in: path
        name: user_id
        schema:
          type: string
        required: true
      - in: path
        name: invitation_id
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserResponseOrgInvitationResponseSchema'
          description: Successful response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Validation error
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Authentication error
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Not found
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
          description: Forbidden
      tags:
      - User v1 - Internal Only
      summary: User Response Org Invitation
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserResponseOrgInvitationRequestSchema'
      security:
      - ApiJwtAuth: []
  /v1/users/{user_id}/saved-opportunities/{legacy_opportunity_id}:
    delete:
    

# --- truncated at 32 KB (88 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/hhs/refs/heads/main/openapi/hhs-user-v1-internal-only-api-openapi.yml