diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
index 63497ab77..2e16f9b36 100644
--- a/.gitlab-ci.yml
+++ b/.gitlab-ci.yml
@@ -30,3 +30,34 @@ deploy-packagist:
    script:
        - STATUSCODE=$(curl -XPOST -H'content-type:application/json' "https://packagist.org/api/update-package?username=$PACKAGIST_USERNAME&apiToken=$PACKAGIST_TOKEN" -d"{\"repository\":{\"url\":\"$CI_PROJECT_URL.git\"}}" --silent --output /dev/stderr --write-out "%{http_code}")
        - if [ $STATUSCODE = "202" ]; then exit 0; else exit $STATUSCODE; fi
+       
+# deploy documentation
+api-doc-build:
+   stage: build-doc
+   environment: api-doc
+   image: chill/ci-image:php-7
+   before_script:
+      - mkdir api-doc
+   script: apigen generate --destination api-doc/$CI_BUILD_REF_NAME/$CI_PROJECT_NAME
+   artifacts:
+      paths:
+         - "api-doc/"
+      name: api
+      expire_in: '2h'
+   only:
+      - master
+      - tags
+
+api-doc-deploy:
+   stage: deploy-doc
+   image: pallet/swiftclient:latest
+   before_script:
+        # test that CONTAINER_API variable is set        
+        - if [ -z ${CONTAINER_API+x} ]; then echo "Please set CONTAINER_API variable"; exit -1;  fi
+        # go to api-doc to have and url with PROJECT/BUILD
+        - cd api-doc
+        # upload, and keep files during 1 year
+   script: "swift upload --header \"X-Delete-After: 31536000\"  $CONTAINER_API $CI_BUILD_REF_NAME/$CI_PROJECT_NAME"
+   only:
+      - master
+      - tags