Prismic Custom Type API Client

1.4.0 2023-12-01 11:28 UTC


Build Status

codecov Psalm Type Coverage

Latest Stable Version Total Downloads


This library provides an API client so that you can read and write your document type definitions using the Prismic Custom Types API.

Currently, you can list, read, insert and update document types.

The client requires that you make use of (And similarly, it returns instances of) the shipped Definition value object.

Typically, you wouldn't interact with the client directly, but as part of a build process that takes care of all that stuff for you. This client is quite fresh, but it's primary use will soon be part of netglue/prismic-cli, so that it will become trivial to synchronise your local development document definitions with those in your production Prismic repository (and vice-versa).


The only supported installation method is via composer:

composer require --dev netglue/prismic-doctype-client


The client has been designed to work with whatever PSR-18 HTTP Client and PSR-7 and PSR-17 implementations that you like to use. Once you have got hold of an API token for the custom types API, you can create a client with:

use Prismic\DocumentType\BaseClient;

$client = new BaseClient(
    $httpClient,     // \Psr\Http\Client\ClientInterface
    $requestFactory, // \Psr\Http\Message\RequestFactoryInterface
    $uriFactory,     // \Psr\Http\Message\UriFactoryInterface
    $streamFactory   // \Psr\Http\Message\StreamFactoryInterface



Currently, authentication is only possible with a permanent access token that you create/retrieve from the Prismic repository settings. Session based tokens are not supported.


CRUD operations on shared slices are not yet implemented but are planned for future development. If you really want this feature, you're welcome to contribute.


Please feel free to get involved with development. The project uses PHPUnit for tests, Psalm for static analysis and Infection for mutation testing. CI should have your back if you want to submit a feature or fix ;)


MIT Licensed.